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THESIS  ABSTRACT 


FIDELITY  OPTIMIZATION  OF  MICROPROCESSOR 
SYSTEM  SIMULATIONS 

Earnest  Taylor  Landrum,  Jr. 

Master  of  Science,  March  19,  1981 
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117  Typed  Pages 
Directed  by  Victor  P.  Nelson 

'The  development  of  a  microprocessor  system  simulation  that  would 
accurately  portray  the  operation  of  the  system  at  a  very  fine  level 
of  detail  was  studied.  This  optimization  in  the  area  of  fidelity  was 
broken  into  three  tasks.  A  preprocessor  program  was  written  to  im¬ 
prove  the  operator  interface  to  an  existing  simulation  driver  program. 
An  existing  microprocessor  simulation,  designed  to  run  under  the  simu¬ 
lation  driver  program,  was  extensively  modified  to  reflect  actual  ma¬ 
chine  level  operations  rather  than  abstract  level  functions.  A  simu¬ 
lation  of  a  programmable  parallel  interface  was  developed  and  mated 
to  the  microprocessor  simulation.  Examples  and  possibilities  for  sys¬ 
tem  level  simulation  are  discussed  and  analyzed.,, 
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I.  INTRODUCTION 


The  work  to  be  described  in  this  thesis  focuses  on  simulation  of 
microprocessor-based  systems,  pursuing  three  related  objectives. 

First,  simulation  routines  must  have  an  efficient  human  interface  to 
allow  effective  interaction  with  the  user  and  efficient  use  of  the 
simulation  capabilities.  Secondly,  the  simulation  program  of  the  tar¬ 
get  machine  should  be  a  highly  faithful  model  of  that  machine,  to 
allow  use  of  the  simulation  results  with  a  minimum  of  corrections  for 
simulator-based  peculiarities.  Finally,  the  target  machine  must  be 
complete  enough  to  accurately  portray  system  operation,  including  in¬ 
put/output  functions. 

Thus,  there  were  three  logically  connected  tasks  to  be  done.  The 
first  task  was  to  develop  a  preprocessor  program  to  increase  the  util¬ 
ity  and  ease  of  operation  of  an  existing  simulator  program,  based  on  a 
hardware  description  language.  The  second  task  was  to  develop  a  mi¬ 
croprocessor  simulation,  avoiding  the  abstract  level  in  favor  of  one 
more  in  line  with  the  actual  operation  of  the  target  machine.  The 
final  task  was  to  develop  the  capability  to  simulate  a  complete  system 
with  input/output  functions. 

The  simulator  program  used  was  the  Computer  Design  Language  Simu¬ 
lator  -  USF  Version  2,  as  run  on  the  computer  system  of  Auburn  Univer¬ 
sity.  This  simulator  program  is  based  on  Computer  Design  Language 
(CDL) ,  a  hardware  description  language  developed  by  Dr.  Yoahan  Chu  of 
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the  University  of  Maryland  (1,2).  Using  an  algebraic  structure,  CDL 
describes  device  operations  at  the  register  transfer  level.  The  main 
advantage  of  the  language  is  this  logical  structure.  Hardware  devices 
are  called  by  commonly  used  names  and  register  transfer  operations  are 
easily  understood.  The  simulator  program  retains  this  clear,  logical 
translation  of  a  hardware  system  into  CDL.  However,  there  are  two 
disadvantages  to  using  the  program.  Initial  program  and  data  load  of 
the  target  machine  must  be  prepared  in  binary  machine  code,  which  can 
be  awkward.  In  addition,  considerable  amount  of  processing  time  is 
necessary,  due  to  the  intensely  iterative  nature  of  the  simulation 
routine. 

The  preprocessor  developed  was  designed  to  remedy  one  of  these 
drawbacks.  The  preprocessor  allows  the  use  of  assembly  language  to 
load  the  target  machine's  simulated  program  space.  This  human  inter¬ 
face  frees  the  user  to  concentrate  on  the  results  of  the  simulation 
rather  than  on  the  mechanics  of  achieving  it.  It  also  provides  a  sim¬ 
ple  set  of  format  and  semantic  checks  to  be  made  on  the  program  to  be 
assembled.  The  prime  requirement  was  to  make  simulation  easier  to 
achieve  and  correct,  thus  more  responsive  to  the  user. 

A  simulation  of  a  microprocessor  was  available  as  a  result  of  an 
earlier  study  (3).  However,  many  of  the  routines  were  written  only  to 
provide  a  correct  output,  without  regard  to  the  mechanism  used.  The 
simulation  was  extensively  modified  to  more  closely  duplicate  the  ac¬ 
tual  operation  of  the  target  machine.  The  functions  of  the  basic  sup¬ 
port  chips  were  defined  more  explicitly.  Using  the  improved  Simula- 
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tion  as  a  basis,  the  functions  of  representative  communications  chips 
were  developed.  The  unique  aspect  of  the  resulting  product  was  its 
ability  to  model  an  integrated  system,  including  input/output  and  in¬ 
terrupt  driven  routines. 

The  body  of  this  paper  will  further  describe  these  three  tasks. 
The  considerations  and  constraints  used  in  the  development  of  the  pre¬ 
processor  are  described  first.  The  next  section  discusses  both  the 
principles  used  to  modify  the  Intel  8080  simulation  for  increased  fi¬ 
delity  and  those  principles  used  to  build  a  parallel  communications 
interface.  The  experimental  results  obtained  from  testing  the  system 
are  then  presented.  The  final  section  contains  the  conclusions  drawn 
from  the  project  and  some  suggested  directions  for  further  work  in 


this  area. 


II.  PREPROCESSOR  DEVELOPMENT 

The  CDL  Simulator  Program  is  designed  for  hardware  simulation  at 
the  register  transfer  level.  At  this  level,  a  processor  operates  by 
logically  decoding  commands  and  data  presented  in  machine  language. 

CDL  is  particularly  efficient  in  expressing  the  decoding  and  execution 
processes.  Although  this  feature  offers  great  flexibility  and  detail 
in  design,  it  becomes  a  drawback  when  simulating  the  execution  of  trail 
programs,  due  to  the  necessity  of  translating  these  programs  into  ma¬ 
chine  language.  The  preprocessor's  major  function  is  to  translate  pro¬ 
grams  written  in  the  assembly  language  of  the  target  machine  into  CDL- 
compatible  machine  code  and  load  them  into  the  assigned  memory  space. 

It  operates  as  an  assembler  and  loader,  with  appropriate  support  func¬ 
tions  such  as  symbol  table  generation.  The  output  of  the  assembler 
routine  is  presented  in  two  forms  for  user  convenience.  The  first  ver¬ 
sion  is  a  line  by  line  translation  of  the  assembly  code.  The  program 
is  displayed  for  analysis  and  correction  of  errors.  The  second  version 
is  the  CDL-compatible  card  image,  displaying  the  machine  code  as  it  is 
presented  to  the  simulation  program.  This  version  is  particularly 
helpful  in  tracing  the  execution  of  the  simulation. 

The  second  design  goal  was  to  provide  the  translation  process  with 
an  adequate  human  interface.  Careful  design  of  the  output,  as  dis¬ 
cussed  above,  was  a  first  step.  Although  the  preprocessor  was  never 
intended  to  be  a  complete  software  development  tool,  routines  were  in- 
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eluded  to  detect  and  flag  the  type  of  errors  likely  to  be  :  i 

executing  trial  programs  on  a  simulated  machine.  Hiese  i  m  lu.ie  h 
syntax  errors  in  the  structure  of  the  trial  program  and  .odlug  errors 
within  the  program  itself.  These  routines  are  limited  to  those  that 
would  be  most  useful. 

An  additional  constraint  was  imposed  on  the  preprocessor.  To 
be  compatible  with  the  existing  CDL  simulation  program,  it  has  to  be 
written  in  FORTRAN.  FORTRAN,  however,  lacks  the  bit-level  instruc¬ 
tions  necessary  to  deal  with  character  data.  Following  the  example 
of  the  basic  simulation  program,  the  preprocessor  implements  several 
required  functions  In  IBM  370  assembly  language  subroutines.  While 
there  Is  a  bonus  in  Increased  execution  speed,  program  linkage  and 
integration  posed  significant  problems  during  development. 

The  choice  of  a  target  machine  was  also  an  important  considera¬ 
tion.  Since  the  preprocessor  works  with  assembly  language,  a  target 
machine  had  to  be  chosen  In  order  to  code  the  assembler.  For  maximum 
utility,  the  preprocessor  would  have  to  work  with  a  significant  ma¬ 
chine,  one  having  widespread  use  and  a  need  to  be  simulated.  It  would 
also  have  to  be  one  that  had  information  on  its  internal  operation 
widely  available.  The  choice  for  this  work  was  the  Intel  8080  micro¬ 
processor. 

The  basic  function  of  the  preprocessor  is  that  of  a  standard  two 
pas3  assembler  and  loader  (4).  While  FORTRAN  does  not  lend  Itself  to 
the  writing  of  structured  programs,  an  attempt  was  made  to  preserve 
logical  form  In  the  program  (Figure  I).  The  program  has  a  central 
FORTRAN  driver  routine,  ASMINT,  that  performs  initialization,  selects 
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Figure  1.  Preprocessor  Program  Structure 
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the  required  language  set,  directs  the  passes  of  the  assembler  and 
outputs  the  final  code,  both  as  hard  copy  and  CDL  compatible  machine 
code  in  the  program  memory  space.  These  major  functions  are  imple¬ 
mented  in  FORTRAN  subroutines,  in  turn  supported  as  necessary  by 
IBM  370  assembly  language  subroutines  (Table  1) .  Assembly  language 
is  used  in  routines  performing  bit  manipulation  and  in  the  routines 
that  are  highly  iterative.  This  structure  supports  the  design  objec¬ 
tives  of  the  preprocessor.  As  part  of  a  time-consuming,  intensely 
iterative  program,  this  segment  has  to  be  relatively  fast  to  avoid 
lengthening  an  already  long  program  in  execution.  To  conserve  mem¬ 
ory  space  and  improve  speed,  it  has  to  be  relatively  small.  To  im¬ 
prove  readability  and  encourage  both  use  and  future  improvements,  it 
has  to  be  relatively  straightforward  and  simple.  The  overall  design 
strategy  was  to  produce  a  limited  implementation  that  stressed  util¬ 
ity  over  optimization.  The  prominent  features  of  the  preprocessor 
are  listed  in  Table  2.  For  a  more  complete  description  of  the  fea¬ 
tures  and  options  of  the  program,  both  the  user's  manual  and  program 
listing  are  included  in  this  work  as  appendices. 

Integration  of  the  preprocessor  into  the  CDL  simulation  program 
posed  several  problems.  There  was  the  language  problem  described 
earlier  with  the  mating  of  FORTRAN  and  IBM  370  assembly  language.  The 
preprocessor  also  had  to  integrate  with  the  CDL  simulator  in  such  a 
way  as  to  preserve  the  human  interface  and  the  logical  continuity  of 
the  main  program.  The  design  solution  to  this  problem  was  to  have  the 
preprocessor  produce  card  images  of  the  assembled  machine  code  and 
load  them  in  accordance  with  the  procedures  for  loading  CDL  simulator 
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First 

AS  MINT 

FORTRAN 

Assembler  driver  routine 

Second 

PASONE 

FORTRAN 

Assembler  first  pass  driver 

PAS TWO 

FORTRAN 

Assembler  second  pass  driver 

IMAGER 

FORTRAN 

Build  card  image  format 

Third 

Utilities 

Character  manipulation  and  assembly 

POPSUB 

FORTRAN 

Pseudo-op  handling 

LODASM 

Assent  ly 

Operation  code  table  loader 

LABLST 

Assembly 

Symbol  table  manager 

PCODE 

Assembly 

Operation  code  table  manager 

STRING 

Assembly 

String  decoder 

OPE RAN 

Assembly 

Operand  numerical  converter 

VALRED 

Assemb ly 

Character  numerical  converter 

Table  1.  Preprocessor  Routine  List 


9 


Assembler  options 
Language 

Symbol  table  listing 
Location  counter  initialization 


Data  types 

Numerical  (decimal, hexadecimal,  octal,  binary) 

Character  strings 

Expressions 


Pseudo-ops 

Assembler  control  (origin  and  end) 

Data  storage  (byte,  word,  space,  equality) 

Input  Assembly  language  program 

Output 

Assembled  code  listing 
Loader  compatible  card  images 


Table  2.  Prominent  Preprocessor  Features 
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memory  space  from  cards.  This  approach  maintained  the  continuity  of 
the  CDL  simulator  and  relieved  the  necessity  of  creating  an  alternate 
method  of  introducing  data  into  the  assigned  program  memory  space  of 
the  simulator. 

Even  though  a  specific  target  machine  was  chosen,  the  prepro¬ 
cessor  was  designed  to  permit  extension  into  other  languages  to  make 
it  more  versatile.  One  of  the  initial  operator  specifications  is 
the  language  to  be  used  by  the  assembler.  This  specification  controls 
the  operation  code  set  selected  by  the  program.  The  pseudo  operation 
codes  are  indexed  to  allow  multiple  routines  to  be  written  to  accom¬ 
modate  the  different  languages.  Complete  commonality,  of  course,  is 
impossible  to  achieve.  The  IBM  370  assembly  language  subroutines  for 
handling  operands  and  addressing  were  specifically  written  to  generate 
Intel  8080  code.  However,  the  modular  structure  of  the  preprocessor 
would  allow  them  to  be  replaced  with  subroutines  suited  for  the  de¬ 


sired  language. 


III.  FIDELITY  OPTIMIZATION  OF  A  SIMULATION 


One  of  the  most  important  attributes  of  a  hardware  simulator  is 
fidelity,  the  degree  to  which  the  simulation  approximates  reality. 
Optimization  of  fidelity  is  the  process  of  balancing  the  requirements 
of  broad  principles  of  simulation,  alternative  methods  of  representa¬ 
tion  available  in  specific  cases,  and  the  priorities  in  performance 
factors  of  the  simulation  as  a  whole.  The  desired  outcome  is  a  faith¬ 
ful  simulation  that  sacrifices  as  little  as  possible  in  attaining  fi¬ 
delity.  This  chapter  describes  the  optimization  process  as  applied 
to  the  specific  case  of  the  Intel  3080  microprocessor  within  the 
constraints  of  the  CDL  simulator. 

Microprocessor  Simulation 

The  operation  of  the  Intel  8080  CPU  can  be  analyzed  down  to  a 
fine  level.  An  instruction  cycle  is  the  time  it  takes  to  fetch  and 
execute  a  single  instruction.  A  machine  cycle  is  generated  each  time 
a  memory  or  I/O  access  is  made.  This  machine  cycle  can  be  subdivided 
into  separate  states.  In  these  individual  states  the  actual  micro¬ 
operations  of  the  CPU  take  place.  Depending  on  the  number  and  type 
of  microoperations  executed  within  the  machine  cycle,  there  are  three, 
four,  or  five  states  in  that  cycle.  The  number  of  machine  cycles  re¬ 
quired  to  complete  an  instruction  depends  upon  the  number  of  accesses 
to  memory  or  I/O.  All  of  the  8080  instructions  can  be  broken  down  in 
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terms  of  machine  cycles  and  states  (5) .  This  analysis  forms  the  ba¬ 
sis  for  the  reality  that  must  be  simulated. 

There  are,  however,  areas  of  operation  where  certain  assumptions 
must  be  made  to  accommodate  the  hardware  description  language  to  the 
processor.  An  outstanding  example  in  this  project  is  the  use  of  flag 
registers.  The  exact  hardware  logic  used  within  the  microprocessor 
to  initiate  certain  sequences  is  embedded  in  the  control  circuits  de¬ 
signed  by  the  manufacturer.  In  order  to  allow  the  simulated  micropro¬ 
cessor  to  initiate  these  sequences,  nonexistent  hardware  registers 
have  to  be  defined  and  assigned  these  functions.  The  prime  example  in 
the  instruction  execution  portion  of  the  simulation  is  the  register  la¬ 
beled  MREF.  This  flag  is  set  whenever  an  instruction  is  to  be  exe¬ 
cuted  using  a  memory  reference  as  an  assigned  register  operand.  This 
register  may  not  exist  in  the  actual  hardware  or  may  not  be  accessible 
by  the  user.  However,  the  simulator  program  can  read  the  status  of 
this  flag  register  and  use  the  results  to  implement  the  sequence  of 
register  transfers  implemented  in  reality.  The  result  is  increased 
fidelity  of  operation.  Further  use  of  this  technique  is  made  in  the 
implementation  of  control  logic  and  will  be  discussed  more  fully  in 
a  later  section. 

Other  general  concepts  should  be  considered  within  an  improved 
simulation.  The  size  of  the  simulation  must  be  kept  to  a  minimum 
by  avoiding  duplicate  procedures.  Transfer  of  control  between  similar 
operations  is  used  where  practical  to  achieve  this  goal.  In  a  similar 
vein,  the  concept  of  execution  overlap  requires  special  handling.  The 
8080  microprocessor  uses  an  overlap  of  the  final  processes  of  certain 
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Instructions  and  the  fetch  of  the  next  instruction.  This  overlap 
is  used  to  increase  the  execution  speed  of  the  machine.  CDL  can 
directly  support  concurrent  processes  only  in  certain  cases.  In¬ 
clusion  of  the  required  extra  routines  to  achieve  the  overlap  is  not 
justified  by  the  small  return  in  authenticity.  The  originally  over¬ 
lapped  processes  are  generally  included  in  the  last  scheduled  machine 
cycle  of  the  instruction  in  this  simulation.  The  execution  speed  in¬ 
crease  is  thus  preserved  by  performing  the  processes  outside  of  machine 
time  and  the  process  is  transparent,  except  at  the  precise  moment  of 
the  overlap.  In  a  few  cases  the  simulation  could  not  perform  the  re¬ 
quired  functions  in  the  required  time,  even  though  they  were  not  over¬ 
lapped.  In  such  instances,  the  simulation  was  designed  to  come  as 
close  as  possible.  These  instances  simply  represent  the  limits  of  the 
ability  of  the  simulation,  normally  visible  only  at  the  subcycle  level. 

The  process  of  bringing  a  simulation  into  strict  compliance  with 
the  actual  operating  principles  is  best  done  in  several  stages.  A  pro¬ 
gram  had  been  developed  to  simulate  the  Intel  8080  in  a  multiprocess¬ 
ing  environment  (3).  Therefore,  the  program  was  concerned  primarily 
with  the  results  of  program  execution  and  the  transfer  of  control  ra¬ 
ther  than  the  strict  simulation  of  a  microprocessing  system.  It  is 
the  basis  for  the  instruction  execution  routine  portion  of  the  im¬ 
proved  simulation.  Varying  degrees  of  fidelity  required  varying 
approaches.  Some  routines  were  completely  rewritten.  The  HLT  in¬ 
struction  is  one  example  (Figure  2).  The  original  sequence  simply 
disables  the  software  mechanism  used  to  translate  clock  pulses  into 
increasing  machine  cycle  numbers.  The  revised  sequence  recognizes 
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ORIGINAL  VERSION 
Hit 

/M( 1) *T(4) *P ( 1) * READY* IR( 7) 1 *IR(6) /  IF  (OP  1 ( 3) *OP2 (2) *OP3(6) )  THEN 
(READY=0,  X=0,  Y= 1)  ELSE  (DO/SEVAL) 


EXPANDED  VERSION 
Hit 

/M( 1) *T( l) *P ( 1)*READY*IR( 7) 1 *IR(6) /  IF  (OPl(3)*OP2(2)*OP3(6))  THEN 
(HLTA= 1 ,  X=0 ,  Y=2)  ELSE  (DO/SEVAL) 

/M(2)*T(1)*P(1) *HLTA* READY/  SYNC=1,  MEMR= I 

/M(2)*T(21*P(1)*HLTA/  WAIT=l,  READY=0 


Figure  2 .  HLT  Command  Routine 
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the  halt,  broadcasts  it  as  the  system  status  and  enters  a  wait  state 
before  disabling  the  software  driver.  The  additional  actions  die  ne¬ 
cessary  to  enable  the  processor  to  communicate  with  other  parts  of 
a  complete  system. 

Some  instructions  were  changed  to  make  more  efficient  use  of  the 
memory  and  I/O  routines  developed  in  the  control  sections.  The  STAX 
and  LDAX  execution  routine  was  expanded  to  include  the  memory  cycle 
that  occurs  and  makes  the  instruction  continue  into  a  second  machine 
cycle.  Several  instructions  were  thus  modified  to  show  single  byte 
I/O  transfer.  Adding  a  cycle  was  generally  done  in  a  straightforward 
manner.  The  single  exception  was  the  immediate  instruction  handler 
(Figure  3).  This  routine  recognizes  the  immediate  instruction  type 
and  fetches  the  required  operand,  using  an  added  memory  cycle.  At 
this  point,  the  machine  cycle  numbers  being  carried  by  the  simulation 
are  incorrect,  even  though  the  elapsed  timing  is  very  close  to  the 
actual.  However,  the  only  alternative  is  to  reproduce  all  of  the  af¬ 
fected  instruction  execution  routines,  changing  only  the  machine  cy¬ 
cle  numbers,  and  then  add  them  to  the  instruction  set.  The  option  that 
was  chosen  was  to  maintain  the  smaller  set  of  routines  and  accept  the 
single  exception  rather  than  to  pay  the  simulation  execution  speed 
penalty  for  redundant  code.  The  simulation  that  results  from  the  sum 
of  all  these  actions  is  a  quite  accurate  model  of  the  Intel  8080  in¬ 
struction  set.  The  next  section  will  discuss  the  development  of  the 
corresponding  control  logic. 
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ORIGINAL  VERSION 

Immediate  Instruction  Handler 

/M( 1) *T(4)*P( 1) *READY*(IR( 7) .ERA. IR(6)) ' *OP3(6) /  ADDBUFFER=PC,  SYNC=1 , 
NWR=  1 ,  DBIN= 1 ,  WAIT= 1 ,  READY=0 

/M( 1) *T(4) *P( 1) *READY*(IR( 7) .ERA. IR(6) ) ' *OP3(6) /  PC=ADDBUFFER. COUNT. , 
TEMP=DATABUFF,  IR(6)=IR(6) ' ,  X=4 

EXPANDED  VERSION 

Immediate  Instruction  Handler 

/M( 1)*T(4) *P( 1) *READY* (IR( 7) .ERA. I R( 6))' *0P3(6) /  ALATCH=PC,  MR1=1, 

X=0,  Y=2 

/M(2)*T(2)*P(1)*READY*(IR(7) .ERA. IR(6) ) ' *OP3(6) /  MR1=0 

/M(2)*T( 3) *P ( 1) *READY* (IR( 7) . ERA. IR(6) ) ' *OP3(6) /  PC=ALATCH , 
TEMP=DATABUFF,  IR(6)=IR(6) ' ,  X=4 ,  Y=1 

Figure  3.  Immediate  Instruction  Handler  Routine 


17 


Control  Functions 

The  most  Important  feature  of  faithful  simulation  of  a  micro¬ 
processor  system  is  control  function  implementation.  While  instruc¬ 
tion  set  implementation  is  easily  structured  to  conform  to  the  ac¬ 
tual  CPU  microoperation  sequences,  the  control  sequences  are  the  key 
to  system  level  simulation.  The  control  sequences  must  operate  on 
two  levels.  The  first  level  is  basic  system  control  of  the  CPU  and 
associated  support  modules.  Functions  at  this  level  include  genera¬ 
tion  of  CPU  status  information  and  basic  memory  access.  The  second 
level  of  control  functions  are  those  necessary  to  drive  unique  system 
modules.  A  specific  example  of  this  level  is  a  communications  mod¬ 
ule  used  to  communicate  with  a  system  peripheral. 

CPU  Support  Group 

The  first  level  of  control  applies  to  the  Intel  8080  CPU  sup¬ 
port  group  of  modules  (Figure  4) .  This  group  includes  the  8080  8-bit 
Microprocessor,  the  8224  Clock  Generator  and  Driver,  and  the  8228  Sys¬ 
tem  Controller  and  Bus  Driver  (6).  The  CPU  itself  has  few  control 
functions  that  are  solely  internal.  One  example  is  the  clock  cycle 
incrementor  function  which  translates  the  incoming  clock  pulses  into 
correct  machine  cycle  and  state  signals.  In  the  simulation  this 
mechanism  also  implements  the  asynchronous  interrupt  function.  The 
other  control  signals  involve  associated  modules.  The  8224  module 
is  actually  not  separately  simulated.  Its  clock  functions  are  impli¬ 
cit  in  the  two  phase  clock  defined  in  the  hardware  section.  Its 
only  other  function,  converting  the  CPU  synchronization  signal  to  a 
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status  strobe  signal,  is  simulated  separately.  The  bulk  of  the  con¬ 
trol  signals  are  concentrated  ii  the  8228.  Its  major  function  is 
the  broadcast  and  application  of  the  system  status.  Triggered  by 
the  status  strobe,  the  simulation  of  the  8228  latches  the  status 
word  from  the  data  bus  and  combines  elements  of  that  status  word  and 
signals  from  the  CPU  in  a  gating  array  to  generate  memory  and  I/O 
access  signals. 

The  control  function  simulations  are  designed  to  operate  similar 
to  nested  subroutines.  The  normal  memory  routines  activate  selected 
status  word  registers  and  the  synchronization  pulse.  The  synchroniza¬ 
tion  pulse  triggers  the  status  strobe,  which  loads  the  8228  status 
latch  via  the  data  bus.  The  gating  array  activates  the  primary  se¬ 
quences  for  memory  access,  listed  in  the  simulation  as  utility  rou¬ 
tines,  and  deactivates  the  ready  signal,  stopping  the  software  driven 
cycle  clock.  After  the  services  are  performed,  the  ready  signal  is 
reactivated  to  allow  the  clock  cycle  incrementor  to  continue.  This 
action  simulates  the  access  speed  requirements.  In  this  particular 
application,  the  memory  is  assumed  to  be  sufficiently  fast  that  the 
wait  state  need  not  be  entered  during  the  access.  The  machine  cycle 
and  state  numbers  remain  correct.  However,  since  CDL  requires  that  all 
actions  be  driven  by  the  system  clock,  the  two  clock  cycles  needed  to 
complete  the  access  are  counted.  This  fact  affects  any  timing  analy¬ 


sis  interpretation. 


The  module  simulated  for  the  second  layer  of  the  system  Is  the 
Intel  8255  Programmable  Peripheral  Interface  (7).  This  device  uses 
a  system  software  generated  control  word  to  program  the  functional 
characteristics  of  three  eight  bit  ports  to  achieve  a  great  number  of 
input  and  output  configurations.  The  8255  was  chosen  for  its  versa¬ 
tility  in  controlling  parallel  communication.  The  programmable  con¬ 
figuration  feature  makes  it  a  very  flexible  device.  However,  the  CDL 
simulator  driver  cannot  support  an  ambiguously  defined  architecture. 
The  hardware  definition  section  accepts  only  a  single  description  of 
each  part  of  the  system.  Once  the  system  design  has  been  translated 
by  the  simulation  driver,  that  design  remains  fixed  throughout  the 
simulation  run,  restricting  the  utility  of  the  software  driven  func¬ 
tional  control.  Complete  flexibility  could  be  obtained  only  by  in¬ 
cluding  software  instructions  for  every  possible  configuration,  down 
to  a  single  bit  level.  These  instructions  would  have  to  be  evaluated 
on  each  iteration  of  the  simulator  to  cor  .tract  the  correct  interface. 
The  software  overhead  penalty  of  processing  all  the  instructions  for 
the  other  unused  configurations  was  considered  excessive.  Therefore 
a  single  representative  configuration  was  chosen  for  simulation. 

The  chosen  configuration  contains  one  strobed  bi-directional  bus 
and  one  input  port,  both  with  appropriate  handshaking  control  lines 
(Figure  5).  Full  interrupt  and  strobing  capabilities  are  included  in 
the  simulated  logic.  While  software  control  of  the  configuration  is 
not  possible,  the  set/reset  function  of  the  control  lines  is  imple¬ 
mented  to  allow  control  of  the  handshaking  signals.  Appropriate  chip 
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select  and  port  select  decoding  logic  is  also  simulated.  Two  rou¬ 
tines  are  added  for  simplicity  in  the  simulation.  The  first  is  an 
initialization  routine  which  establishes  the  starting  states  of  the 
handshaking  lines.  This  routine  shortens  the  simulated  program  by 
removing  some  housekeeping  sequences.  The  second  routine  corresponds 
to  a  switch  setting  that  simulates  input  to  the  8255  by  transferring 
memory  data  to  the  input  port.  This  routine  was  necessary  since  there 
is  no  way  to  input  external  data  to  a  CDL  simulated  machine  during  a 
simulation  run.  Switch  statements,  which  are  internal  to  the  program, 
can  only  simulate  true  external  inputs.  Any  process  must  be  self- 
contained,  as  is  this  one. 

Although  parallel  communication  is  a  fairly  straightforward  re¬ 
gister  transfer  operation,  simulation  of  serial  communication  in  CDL 
is  a  more  complex  task.  The  actual  hardware  simulation  is  relatively 
simple.  Necessary  components  would  include  a  holding  register  for  the 
byte  being  transferred,  a  pointer  to  the  next  bit  to  be  handled,  and 
logic  to  implement  the  necessary  line  protocol.  The  complexity  arises 
in  timing  the  transfer  of  the  inf ormat ion.  As  noted  before,  the  CDL 
simulator  does  not  handle  concurrent  tasking  well.  A  central  clock  is 
defined  which  provides  all  timing  information.  As  in  the  CPU  simula¬ 
tion,  a  software  counter  mechanism  would  be  necessary  to  define  the 
internal  timing  for  the  serial  transfer.  The  hardware  and  software 
constructs  necessary  for  the  serial  interface  would  lengthen  the  sim¬ 
ulation  substantially.  The  simulation  driver  has  a  limit  on  the  amount 
of  hardware  that  it  can  incorporate  into  the  translated  architecture. 
There  is  no  limit  imposed  on  the  software,  but  due  to  the  sequential, 


iterative  nature  of  the  driver,  a  penalty  in  execution  speed  is  paid 
for  each  statement.  These  limitations  did  pot  favor  an  additional 
interface . 

A  second  reason  for  not  implementing  the  serial  interface  was 
evident  from  the  nature  of  its  operation.  For  low  speed  applications, 
at  300  bits  per  second,  the  software  timing  counter  would  need  a 
maximum  count  of  6,600  central  clock  cycles  to  process  a  single  bit. 
High  speed  applications,  typically  2400  bits  per  second,  would  still 
require  around  830  cycles  per  bit.  Based  on  simulation  runs  made  in 
this  project,  such  a  simulation  would  require  in  excess  of  ten  minutes 
of  CPU  time  for  that  single  bit  transfer  at  2400  bits  per  second,  due 
to  the  granularity  of  the  time  base.  The  time  could  be  reduced  by 
simulating  the  serial  interface  separately  from  the  rest  of  the  sys¬ 
tem.  Accomplishing  this  simulation  would  require  that  the  hardware 
design  described  earlier  and  the  appropriate  logic  functions  for  that 
design  be  substituted  for  the  sections  relating  to  the  8255  module. 
This  would  allow  serial  communication  simulation,  but  not  parallel 
communication  simulation.  If  the  two  were  to  be  simulated  together, 
one  way  to  make  the  effort  feasible  in  terms  of  required  CPU  time 
would  be  to  employ  a  separate  clock  with  an  artificially  compressed 
time  base  in  the  serial  communication  simulation  and  manually  correct 
the  timing  later.  For  this  particular  project,  serial  communication 
simulation  did  not  appear  to  be  a  subject  to  pursue. 


IV.  EXPERIMENTAL  RESULTS 


The  first  proof  required  of  any  computer  program  is  whether  or 
noc  it  indeed' does  perform  its  intended  functions.  Demonstrating 
this  fact  for  the  preprocessor  developed  for  this  thesis  actually  in¬ 
volves  two  factors.  The  preprocessor  must  perform  the  functions  of 
an  assembler  and  initiate  the  simulation.  While  doing  this,  it  must 
also  demonstrate  the  fidelity  for  which  it  was  optimized. 

The  initial  pages  of  output  from  a  run  of  the  program  are  pre¬ 
sented  in  Figures  6,  7,  and  8.  The  symbol  table  and  the  assembled 
listing  of  the  program  to  be  simulated  are  presented  in  Figure  6.  The 
loadable  version  of  the  program,  with  associated  location  counter  val¬ 
ues,  is  shown  below  the  listing.  This  simple  program  utilizes  an  in¬ 
terrupt  driven  routine,  triggered  by  the  8255  chip,  to  retrieve  and 
store  an  externally-input  character.  The  main  routine  uses  the  con¬ 
trol  word  function  and  the  output  function  of  the  8255,  as  well  as  pro¬ 
viding  a  main  processing  stream  to  be  interrupted. 

Figures  7  and  8  are  the  initial  sections  of  the  output  from  the 
simulation,  triggered  by  the  preprocessor  after  it  has  loaded  the  as¬ 
sembled  program  into  the  simulated  memory.  The  individual  entries  give 
the  hexadecimal  values  of  selected  registers  during  each  clock  cycle. 
The  changes  in  these  registers,  established  in  the  hardware  definition 
section  of  the  simulator  program,  trace  the  execution  of  the  program. 
The  output  presented  illustrates  the  type  of  information  collected. 
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Due  to  the  extremely  large  amount  of  data  that  is  produced,  only 
these  samples  are  shown. 

As  stated  earlier,  a  measure  of  the  fidelity  of  a  simulation  can 
be  made  using  a  timing  analysis.  Inspection  of  the  microoperation 
sequences  can  show  that  the  individual  operations  correspond  to  the 
target  machine,  but  only  a  timing  analysis  can  demonstrate  the  inte¬ 
gration  of  the  system  as  a  whole.  A  timing  analysis  also  serves  to 
highlight  any  timing  irregularities  inserted  by  the  mechanics  of  the 
simulation.  An  example  of  this  type  of  analysis,  using  the  simulation 
developed  for  this  project,  is  presented  in  Figure  9.  The  figure 
lists  the  assembly  language  program  run  by  the  simulation  and  presents 
an  accounting  and  comparison  of  the  timing  factors. 

The  analysis  illustrates  two  of  the  irregularities  of  the  simula¬ 
tion  that  were  discussed  earlier  in  the  paper.  The  first  is  the  extra 
clock  cycle  added  to  all  immediate  operations,  such  as  MVI  (MoVe  Imme¬ 
diate).  The  alternative  to  this  added  cycle  was  to  create  a  separate 
routine  for  each  immediate  operation,  an  alternative  judged  to  be  far 
less  acceptable.  The  second  factor  shown  is  the  presence  of  two  clock 
cycles  added  to  each  memory  and  I/O  access.  As  explained  earlier,  this 
factor  is  introduced  by  the  software  timing  mechanism.  Even  though 
the  mechanism  is  not  updating  the  machine  cycle  and  state  numbers  dur¬ 
ing  an  access,  the  master  clock  must  continue  to  run  to  provide  exe¬ 
cution  timing.  The  cycle  and  state  numbers  remain  correct,  but  the 
clock  cycle  timing  must  include  a  correction  factor  to  account  for  the 
extra  cycles.  The  analysis  must  also  account  for  program  dependent 
conditions.  The  interrupt  generated  in  the  execution  of  this  program 
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Operation 

Cycle  Time 

Factor 

Total 

PUSH  PSW 

10 

6 

16 
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7 

4+1 

12 
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10 

6 

16 
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7 

4+1 

16 

OUT 

10 
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16 

IN 

10 

6 

16 

STA 

13 
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21 
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10 

6 

16 

El 
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RET 
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16 

El 
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MVI 

7 

4+1 

12 

OUT 

10 
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16 

LDA 

13 

8 

21 

OUT 

10 

6 

16 

HLT 

7 

2 

_ 9 

224 


Operation  times  224 
Interrupt  time  14 

Startup  time  _ 1_ 

239  clock  cycles 


Figure  9.  Timing  Analysis 
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is  handled  by  the  8228  module  as  a  RESTART  7  instruction,  producing 
14  clock  cycles  that  have  no  apparent  source  in  the  program  code.  As 
shown  in  the  figure,  all  of  these  times  may  be  added  together  to  pro¬ 
duce  a  time  estimate,  measured  in  clock  cycles.  This  estimate  agrees 
exactly  with  the  timing  of  the  simulation  run  of  the  program. 


V.  CONCLUSIONS 


The  project  described  in  this  paper  is  mainly  the  proof  of  a 
concept.  The  ability  of  the  CDL  simulator  to  accept  the  integration 
of  a  preprocessor  and  faithfully  simulate  a  microprocessor-based  sys¬ 
tem  is  evaluated  by  attempting  an  implementation  of  those  tasks.  The 
effort  was  directed  at  making  the  implementation  succeed  rather  than 
making  it  highly  practical.  Yet  the  practicality  of  this  simulation 
is  certainly  one  of  its  strongest  assets. 

Certainly,  the  first  candidate  for  application  of  this  package 
is  hardware  simulation,  the  most  common  use  of  simulator  packages. 
Simulation  permits  the  comparison  of  alternate  constructs  at  any  level, 
from  single  devices  to  system  architectures,  to  provide  performance 
data  without  the  investment  and  tine  penalty  of  actual  hardware  con¬ 
struction.  Such  a  process  can  be  used  to  fine  tune  a  system  for  a 
specific  application.  The  simulation  of  software  is  a  less  obvious 
candidate  for  application,  but  the  same  refinement  process  can  be  used 
to  view  program  execution  on  a  time-phased,  register- transfer  level. 
Such  refined  software  would  be  useful  for  the  highly  compact,  intensely 
iterative  programs  normally  stored  in  read-only  memory  for  process  con¬ 
trol  or  communications  handling  devices. 

To  facilitate  application  of  this  simulator,  there  are  several 
improvements  that  can  be  made.  These  improvements  range  in  difficulty 
from  major  revisions  to  relatively  simple  extensions  of  the  existing 
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program.  Language  versatility  is  one  of  the  simple  extensions.  The 
preprocessor,  as  currently  written,  will  service  only  the  Intel  8080 
assembly  language.  However,  the  necessary  mechanisms  for  choice  of  a 
language  set  are  already  included  in  the  preprocessor  program.  The 
alternative  language  would  have  to  be  reduced  to  a  table  format  com¬ 
patible  with  the  preprocessor.  Pseudo-operation  routines  would  have 
to  be  written  and  included  in  the  already  stored  subroutine.  Finally, 
alterations  would  have  to  be  made  to  the  routines  for  operand  inter¬ 
pretation  if  the  conventions  of  the  desired  alternative  differed  sub¬ 
stantially  from  those  of  the  8080  assembly  language.  Due  to  the  in¬ 
creased  storage  requirements  for  these  alternative  user-selected  op¬ 
tions,  the  most  effective  implementat ion  of  these  features  might  be 
to  compile  complete  versions  of  the  simulator  package  for  each  lang¬ 
uage  to  be  used  and  have  them  user-selected  as  a  part  of  basic  program 
selection.  This  method  would  allow  versatility  without  sacrificing 
program  compactness. 

Another  avenue  for  improving  the  simulation  lies  in  that  of  sim¬ 
ulator  expansion.  The  current  version  of  this  program  proves  that 
system  simulation  is  feasibLe.  To  make  the  simulator  more  useful,  a 
library  of  module  and  device  simulation  routines  could  be  developed. 

The  hardware  modules  and  microprocessor  simulations  could  be  selected 
to  produce  the  desired  system  configuration.  Addition  of  an  assembly 
language  program  for  the  target  processor  would  complete  the  system 
simulation,  ready  for  input  in  the  simulator. 

The  greatest  return  in  efficiency  could  be  reaped  after  the  great¬ 
est  effort  in  program  improvement:  restructure.  The  current  program 
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is  time  consuming  not  only  because  it  is  so  intensely  iterative,  but 
because  it  suffers  from  the  time  penalties  imposed  by  its  base  lang¬ 
uage  and  structure.  FORTRAN  shares  the  algebraic  format  of  CDL,  but 
the  deeply  nested  subroutine  calls  and  complex  logic  used  in  the  sim¬ 
ulator  do  not  lend  themselves  to  time-efficient  computation.  The  use 
of  structured  programming  could  help  to  streamline  the  sequence  of 
subprograms  being  called  and  avoid  some  of  the  machine  overhead  in¬ 
volved  in  those  calls,  even  at  the  expense  of  some  redundant  coding  in 
different  routines.  The  use  of  a  structured  language,  such  as  PASCAL, 
could  produce  even  more  comprehensive  changes.  Constructs  such  as 
the  CASE  statement  could  replace  sections  of  decoding  logic  and  dras¬ 
tically  reduce  execution  time  while  improving  program  flow.  The  bit 
manipulation  functions  lacking  in  FORTRAN  could  possibly  be  incorpor¬ 
ated  through  the  alternate  language,  eliminating  the  necessity  for 
sizable  assembly  language  subroutines  to  perform  those  functions.  The 
resulting  program  unification  would  certainly  be  a  significant  achieve 
ment.  A  restructured  program  might  also  be  3ble  to  handle  concurrent 
processes  with  greater  ease  by  eliminating  the  need  to  evaluate  every 
conditional  microstatement  on  every  iteration  of  the  program.  As 
stated  before,  the  effort  involved  in  a  restructure  is  extensive,  but 
the  resulting  improvements  in  utility  and  computational  speed  would 
be  most  impressive. 

Simulation  is  an  important  tool  in  system  design.  Its  merit  rest 
in  its  ability  to  save  money  and  effort  by  providing  results  of  tests 
on  system  configurations  that  exist  only  on  paper.  The  simulation 
package  developed  in  this  project  attempts  to  combine  the  important 
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user-oriented  features,  high  level  of  detail,  and  easily  interpret¬ 
able  simulation  results.  There  are  ample  opportunities  to  use  the 
system  as  it  exists  and  system  improvements  options  exist  at  various 
levels  of  effort.  The  possibilities  of  microprocessor-based  system 
simulation  are  limited  only  by  the  imagination  and  energy  of  the  user. 
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FOREWARD 


This  manual  is  based  mainly  upon  information  presented  in  the 
original  user's  manual  compiled  by  Terry  Cwik.  The  manual  was  re¬ 
written  and  restructured  to  include  material  on  the  functional  des¬ 
cription  of  the  CDL  simulator  as  well  as  its  syntax  and  to  improve 
the  clarity  of  the  original  manual.  The  user's  manual  for  the  CDL 
simulator  preprocessor  was  also  added. 

Syntax  in  this  manual  is  presented  in  a  standard  notation.  For¬ 
mats  are  presented  on  a  line  separate  from  the  text.  Upper  case 
items  refer  to  entries  which  must  be  made  exactly  as  shown.  Lower 


case  Items  refer  to  types  of  entries  only.  All  delimiters,  such  as 
slashes  and  parentheses,  are  considered  significant  and  required. 
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Introduc  t ion 


Computer  Design  Language  (CDL)  was  originally  designed  by  Dr. 
Yaohan  Chu  in  1965.  It  was  designed  to  represent  the  architecture  and 
operation  of  computer  hardware  at  the  register  transfer  level,  using 
an  algebraic  notation.  The  language  is  versatile  enough  to  serve  two 
major  purposes.  CDL  can  serve  as  a  standard  language  for  defining  the 
structure  of  digital  systems,  especially  in  an  instructional  setting. 
The  language,  used  with  a  simulator  program,  can  also  be  used  in  the 
simulation  of  existing  digital  systems  or  in  the  testing  and  develop¬ 
ment  of  new  systems.  This  handbook  is  intended  as  an  aid  in  using 
CDL  in  this  second  manner,  with  an  incorporated  simulator  program, 

CDL  Structure 

The  CDL  simulator  program  works  in  several  logical  steps.  The 
first  step  is  accomplished  by  the  translator  section.  The  logical 
design  of  the  subject  hardware,  written  in  CDL,  is  read  into  the  host 
computer  as  card  images.  The  translator  converts  the  hardware  design, 
in  the  form  of  declaration  statements,  into  a  form  suitable  for  com¬ 
puter  manipulation,  namely  groups  of  tables  and  a  pseudo  program 
called  the  Polish  string. 

This  information  is  passed  to  the  simulator  section,  composed  of 
five  routines.  The  loader  routine  accepts  programs  and  data  to  be 
loaded  into  the  simulated  memory  or  specified  registers  in  the  design. 
The  simulator  routine  controls  the  execution  of  the  test  program.  The 
switch  routine  incorporates  the  options  of  manual  switch  settings. 

The  output  routine  controls  the  identity  and  frequency  of  output  value 
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produced  by  the  simulation.  The  simulation  may  be  reinitialized  for 
another  test  by  the  reset  routine. 

Translator  Section 

The  first  task  in  using  CDL  for  simulation  is  to  specify  the  de¬ 
sign  of  the  selected  logical  circuit  in  CDL  terms.  This  specifica¬ 
tion  normally  occurs  in  two  phases.  In  the  definition  phase,  the  hard¬ 
ware  architecture  of  the  system  is  stated.  In  the  operational  phase, 
the  logical  actions  of  the  system  are  defined  at  the  register  trans¬ 
fer  level.  The  definition  phase  consists  mainly  of  declaration  state¬ 
ments,  defining  the  hardware  elements  as  variables,  so  that  they  can 
be  used  in  expressing  the  operation  phase  statements. 

Declaration  Statements.  These  statements  are  used  to  define  ba¬ 
sic  hardware  units.  The  following  devices  are  defined  in  CDL: 


RECISTER 

SWITCH 

SUBREGISTER 

TERMINAL 

MEMORY 

BLOCK 

DECODER 

CLOCK 

LIGHT 

BUS 

The  first  four  characters  of  each  device  name  are  significant  to  the 
simulator.  The  syntax  of  the  declaration  statement  is 

device  name,  list 

The  device  name  begins  in  column  two  and  the  comma  trailing  the  device 
name  is  required.  The  devices  are  discussed  in  more  detail  below. 
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REGISTER  Declaration.  An  individual  register  is  defined  by  a 
name  and  a  number  in  parentheses.  This  number  defines  the  length  and 
order  of  the  bit  positions.  Default  value  of  the  number  is  a  single 
bit.  Examples  are  presented  in  Figure  A-2. 

SUBREGISTER  Declaration.  This  declaration  identifies  a  section 
of  a  previously  declared  register.  The  declared  register,  followed 
by  the  subregister  name,  is  equated  to  a  certain  string  of  bits  within 
that  register.  Subregister  names  must  be  unique  to  the  four  signifi¬ 
cant  characters,  even  when  referenced  to  different  registers.  Examples 
are  presented  in  Figure  A-l. 

MEMORY  Declaration.  A  memory  is  referenced  by  its  name  and  a 
previously  declared  register  which  will  be  its  address  register.  The 
range  of  the  address  and  the  bit  order  of  the  words  in  the  memory  are 
specified.  Thus, 

MEMORY,  M(R)  =  M(0-99,  7-0) 
defines  a  100  byte  memory  space  named  M. 

DECODER  Declaration.  This  declaration  defines  a  device  which 
equates  each  value  of  the  contents  of  all  or  a  section  of  a  previously 
defined  register  to  a  single  output.  The  decoder's  name  and  range  of 
values  is  equated  to  the  register  or  section  of  a  register.  Examples 
are  presented  in  Figure  A-l. 

CLOCK  Declaration.  A  clock  is  defined  for  the  purpose  of  event 
synchronization.  It  can  only  be  referenced  in  a  label  expression,  to 


be  defined  later.  The  clock  is  defined  by  its  name  and  a  number,  one 
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less  Chan  the  number  of  discrete  timing  levels  desired.  Examples  are 
presented  in  Figure  A-l. 

SWITCH  Declaration.  An  external  switch  condition  can  be  simulated 
by  this  declaration.  It  is  defined  by  the  switch  name  and  possible 
positions,  initial  position  first.  A  maximum  of  ten  switch  positions 
is  permitted.  An  example  of  the  definition  format  would  be 
SWITCH,  STRT  (OFF,  ON),  TEMP  (Tl,  T2,  T3). 

In  use  a  switch  may  be  either  set  or  read.  To  set  a  switch,  the  name 
is  equated  to  the  desired  position,  such  as  STRT  =  ON.  A  switch  is 
read,  giving  a  value  of  1  or  0,  by  citing  the  switch  and  a  position, 
such  as  STRT  (ON). 

TERMINAL  Declaration.  Logical  networks  or  multiple  references 
for  a  single  device  are  handled  by  the  TERMINAL  declaration.  The 
terminal  is  simply  defined  in  terms  of  previously  declared  devices. 

Its  use  may  be  very  similar  to  a  DECODER  declaration.  Examples  are 
presented  in  Figure  A-l. 

LIGHT  Declaration.  Panel  lights  may  be  included  by  using  this 
declaration.  As  in  the  SWITCH  declaration,  the  light  is  named  and 
its  states  given,  initial  state  first. 

LIGHT,  RUN  (OFF,  ON),  PWR  (ON,  OFF) 
is  a  typical  example.  The  set  and  read  options  also  follow  the  form 
of  the  SWITCH. 

BUS  Declaration.  A  bus  is  defined  in  terms  of  its  width  in  lines, 
as  in  BUS,  DATA  (0-7),  ADDR  (0-15). 
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BLOCK  Declaration.  This  construct  is  actually  a  software  mech¬ 
anism,  similar  to  a  subroutine.  The  BLOCK  name  serves  as  a  title  for 
a  group  of  microstatements,  as  defined  below.  The  microstatements  are 
enclosed  in  parentheses,  with  nesting  and  such  options  as  IF,  THEN, 
ELSE  allowed.  This  group  of  statements  is  called  to  be  executed  by  a 
DO  statement,  in  Che  form 

DO/block  name. 

Thus 

BLOCK,  SWAP  (A=B,  B=A) 

would  be  called  by 

DO/ SWAP. 

Micro  Statements 

Once  the  hardware  architecture  has  been  defined,  the  logic  func¬ 
tions  impressed  on  these  elements  are  defined  using  microstatements. 
The  basic  form  of  a  microstatement  is 

variable  =  expression 

An  expression  is  a  group  of  variables  and  their  associated  operators. 

The  standard  operators  listed  in  Table  A-l  are  available  for  use 

in  raicrostatements.  Special  operators  may  be  defined  by  the  user  in 

a  separate  subprogram.  This  subprogram  is  of  the  form 

*OPERATOR,  first  argument , name , second  argument 
//  operations  comprising  the  function  of  the 
operator,  RETURN  END 

Argument  names  must  include  bit  structure  if  over  one  bit.  The  se¬ 
cond  argument  is  necessary  only  for  binary  operators.  The  blank  la¬ 
bel,  //,  will  cause  immediate  execution  of  the  listed  operations  when 
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the  operator  is  invoked  by  its  name.  The  subprogram  is  terminate: 
by  the  RETURN  and  END.  Table  A- 1  also  lists  several  special  operators 
built  into  the  simulation  program. 

Microstateraents  have  several  forms.  An  unconditional  microstate¬ 
ment  is  of  the  form 

variable  =  expression. 

The  effect  of  this  construct  is  to  replace  the  named  variable,  a  stor¬ 
age  element,  with  the  result  of  the  expression.  The  named  variable, 
either  a  device  or  a  part  of  a  device,  must  not  be  replaced  more  than 
once  in  any  set  of  microstatements  to  be  performed  during  a  single 
cycle. 

A  conditional  microstatement  is  of  the  form 

IF  (expression)  THEN  (micros'-atements) . 

If  the  expression  contained  in  the  parentheses  following  the  IF  is 
true,  thus  equal  to  1,  then  the  microstatements  following  the  THEN  are 
executed;  otherwise,  they  are  simply  skipped.  This  form  may  be  extended 
to  the  form 

IF  (expression)  THEN  (microstatements)  ELSE  (microstateraents). 
Execution  is  identical  to  the  first  form,  except  that  when  the  expres¬ 
sion  is  false,  the  microstatements  following  the  ELSE  are  executed. 

These  forms  may  be  nested  by  using  the  precedence  rules  of  parentheses. 
This  nesting  capability  can  be  used  to  design  complex  and  powerful  de¬ 
cision  functions. 

Microstatements  are  used  to  build  other  types  of  statements.  The 
switch  statement  has  the  form 


/  switch  name  (position)  /  microstatements. 
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If  the  named  switch  is  in  the  indicated  position,  the  microstate¬ 
ments  are  executed;  otherwise,  they  are  not.  This  construct  sim¬ 
ulates  the  sensing  of  switch  positions. 

The  most  common  statement  in  simulations  is  the  label  statement. 
It  has  the  form 

/  label  /  microstatements 

where  a  label  is  the  logical  AND  of  an  expression  and  a  clock  level. 
The  expression  must  not  include  a  reference  to  a  clock  level.  When 
the  expression  and  the  clock  level  are  both  logically  true,  the  mi¬ 
crostatements  are  executed.  This  construct  simulates  the  execution  of 
time-phased  logic. 

Finally  there  is  the  end  statement.  The  word  END  indicates  the 
physical  end  of  the  statements  defining  a  system  design.  It  termi¬ 
nates  the  translation  process  and  causes  control  to  pass  to  the  simu¬ 
lator  routines. 


Simulator  Section 

Once  the  hardware  and  operational  definitions  have  been  made,  the 
simulator  is  prepared  to  execute  the  test  program.  The  execution 
is  carried  out  in  a  loop  of  processes  called  the  label  cycle.  During 
each  cycle,  four  tasks  are  performed.  First,  if  any  switch  action  is 
designated  to  occur  in  the  current  label  cycle,  the  executable  state¬ 
ments  that  it  activates  will  be  performed.  Secondly,  'all  label  values 
are  evaluated  and  those  with  true  label  expressions  are  noted.  Third, 
the  statements  corresponding  to  the  true  labels  are  executed.  All 
values  resulting  from  these  statements  are  evaluated,  collected,  and 
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then  stored.  Fourth,  it  is  determined  if  the  simulation  should  be 
terminated  at  this  point.  If  not,  the  next  label  cycle  is  begun.  If 
it  is  terminated,  a  RESET  routine  may  be  called  to  begin  another  simu¬ 
lation. 


Syntax 

As  with  all  computer  programs,  there  are  syntax  rules  which  must 
be  obeyed  if  the  program  is  to  function  as  specified.  There  are 
general  syntax  rules  for  the  use  in  all  statements  and  control  cards 
to  direct  the  sequencing  of  the  simulator  program;  the  Job  Control 
cards  necessary  to  run  this  program  will  be  considered  separately. 


General  Syntax 

Variables.  A  variable  must  be  defined  in  a  declaration  statement 
before  it  can  be  used  elsewhere.  A  variable  may  consist  of  one  to 
four  characters.  The  first  character  must  be  alphabetic.  Embedded 
blanks  and  special  characters  other  than  :/"»  "■"» 

or  "="  are  simply  ignored  and  dropped.  Longer  variable  names 
may  be  used,  but  the  translator  uses  only  the  first  four  significant 
characters.  Thus  "START  1" ,  "START2",  and  "STAR"  are  all  treated  as 
"STAR"  by  the  simulator.  The  following  words  are  reserved  and  must 
not  be  used  as  variable  names:  IF,  THEN,  ELSE,  DO,  CALL,  RETURN,  and 
END. 


Constants.  Three  forms  of  numerical  constants  are  available  for 
use.  A  hexadecimal  constant,  denoted  by  a  colon  preceding  its  digits, 
is  accepted  up  to  a  maximum  of  eight  digits.  A  binary  constant,  de¬ 


noted  by  a  semicolon  preceding  its  digits,  is  accepted  up  to  a  maximum 
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of  32  digits.  A  decimal  constant,  denoted  by  no  delimiter,  is  ac¬ 
cepted  up  to  a  maximum  of  nine  digits.  Blanks,  special  characters 
other  than  those  listed  above,  and  characters  outside  the  set  permis¬ 
sible  for  the  particular  form  are  ignored  and  dropped. 

Continuations .  Declaration  statements  are  continued  to  subsequent 
cards  by  placing  a  "1"  in  column  one  of  the  subsequent  cards.  Label 
and  Switch  statements  are  continued  to  subsequent  cards  by  leaving 
column  one  blank.  All  statements  are  limi ced  to  250  terms,  where  a 
term  is  considered  to  be  either  a  variable,  a  constant,  or  a  valid 
special  character. 

Comment  Cards.  Placing  a  "C"  in  column  one  will  produce  a  com¬ 
ment  line,  ignored  by  the  translator.  Placing  a  "C"  in  column  one  of 
subsequent  cards  allows  continuation  of  the  comment. 

Card  Format.  Declaration  statements,  labeled  statements,  and 
END  statements  may  be  punched  anywhere  in  columns  two  through  72. 

Column  one  is  used  only  for  comments  and  continuations.  Free  use  of 
blanks  is  permitted  and  is  encouraged  to  promote  readability. 

Control  Cards.  Control  cards  are  used  to  call  the  functional  ele¬ 
ments  of  the  simulation  system  into  action.  These  cards  will  be  dis¬ 
cussed  in  the  order  in  which  they  will  normally  be  encountered. 

Translator.  The  translator  is  called  first  to  translate  the  de¬ 
sign  information  into  a  form  suitable  for  simulation  by  the  program. 

The  first  column  contains  the  control  symbol  followed  by  the 

control  word  TRANSLATE  or  TRANS.  The  translator  will  retain  control 
until  the  next  card  with  the  control  symbol  in  column  one  is  read. 

The  design  deck  must  begin  with  tile  control  card  (MAIN,  where  the  se- 
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condary  control  symbol  appears  in  column  one.  The  design  deck 
is  terminated  using  an  End  card,  with  END  in  columns  one  through  three. 
If  special  operators  are  to  be  defined,  they  are  separated  from  the 
rest  of  the  translation.  The  special  operator  defintions  are  all 
started  with  the  *OPERATOR  card  and  closed  with  the  END  card. 

Simulator.  Control  is  next  passed  to  the  simulator  by  the  $SIMU- 
LATE  card,  with  the  control  symbol  in  the  first  column.  Asterisk  con¬ 
trol  cards  are  used  to  pass  control  between  the  simulator's  five  rou¬ 
tines:  Output,  Switch,  Load,  Simulate,  and  Reset.  Unlike  the  pre¬ 
ceding  example,  END  cards  are  not  necessary  to  separate  sections. 

The  Output  routine  specifies  the  format  of  the  printed  output 
of  the  simulation.  The  format  of  the  control  card  is  as  follows: 
columns  1-7  *Ob'TPUT 

columns  11-15  CLOCK  or  LABEL 

columns  16-21  (n,m)= 

columns  22-72  list 

The  CLOCK  or  LABEL  designation  controls  whether  data  is  output  on  clock 
cycles  or  label  cycles,  beginning  on  the  nth  cycle  and  repeating 
every  mth  cycle  thereafter.  The  list  following  specifies  the  regis¬ 
ters,  memory  locations,  and  other  devices  whose  value  is  to  be  out¬ 
put  each  time.  Continuation  cards  for  the  list  are  permissible  as 
long  as  column  one  is  left  blank.  All  output  values  are  listed  in 
hexadecimal  format,  regardless  of  input  format. 

The  Switch  routine  allows  the  simulation  of  manual  switch  set¬ 
tings.  A  separate  card  is  necessary  for  each  switch  action.  It  has 


the  following  format: 
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columns  1-7  *SWITCH 

columns  11-12  n, 

column  13  switch  name  =  switch  position 

The  number  n  specifies  the  label  cycle  before  which  the  switch  action 
occurs.  The  switch  name  and  its  position  must  have  been  declared  pre¬ 
viously.  In  the  output,  each  switch  action  will  cause  an  output  with 
a  heading  which  states  that  the  switch  action  has  occurred. 

The  Load  routine  stores  test  programs  and  data  in  memory  and  re¬ 
gisters.  The  *LOAD  card  precedes  the  data  cards.  Data  cards  use  col¬ 
umns  2  through  72,  with  free  use  of  blanks  permitted.  There  are  no 
continuation  cards.  Each  card  must  be  begun  in  column  2  and  be  self- 
sufficient.  A  data  card  may  contain  a  number  of  lists,  separated  by 
commas.  Only  declared  full  registers  and  full  memory  locations  may  be 
loaded.  The  format  for  the  two  types  of  entries  are  different.  Re¬ 
gisters  are  loaded  with  the  format 

"register  name  =  n" , 

where  n  is  the  value  to  be  loaded.  There  are  three  variations  of  the 
format  for  loading  memory  locations.  Single  memory  locations  can  be 
loaded  in  the  form 

M(m)  =  n, 

where  M(m)  denotes  location  m  of  memory  M  and  n  denotes  the  value  to 
be  loaded.  Multiple  consecutive  locations  can  be  loaded  in  the  form 

M(ral-rax)  =  nl,n2, . . . ,nx, 

where  locations  1  through  x  are  loaded  with  values  nl  through  nx.  The 
ending  address  may  also  be  implied  rather  than  stated  in  the  form 

M(ml-)  =  nl,  n2,...,ny, 


50 


where  consecutive  memory  locations  are  loaded,  beginning  with  ml  and 
continuing  until  y  locations  are  filled.  There  is  a  software  imposed 
limit  of  80  load  entries. 

The  Simulate  routine  initiates  the  actual  simulation  subprogram. 
The  control  card  specifies  the  simulation  termination  parameters.  It 
has  the  following  format: 

columns  1-4  *SIM 

columns  11-  n,m 

The  number  n  specifies  the  maximum  number  of  label  cycles  to  be  gen¬ 
erated.  The  number  m  specifies  the  maximum  number  of  consecutive  la¬ 
bel  cycles  to  be  allowed  without  a  change  in  the  active  labels.  When 
m  label  cycles  have  passed  with  no  changes,  the  simulation  is  auto¬ 
matically  terminated. 

The  Reset  routine  performs  reinitialization  of  the  simulator  sub¬ 
program  to  allow  another  run  of  the  simulator  on  the  same  design.  The 
control  card  has  the  following  format: 

columns  1-6  *RESET 

columns  11-  options 

The  options  are  one  or  more  of  the  following  terms,  separated  by  com¬ 
mas.  CLOCK  resets  the  clock  cycle  only.  CYCLE  resets  the  label 
cycle  counter  and  the  clock  cycle  counter.  OUTPUT  resets  the  previ¬ 
ously  requested  output  parameters,  just  as  SWITCH  resets  the  previ¬ 
ously  requested  manual  switch  operations.  In  both  cases,  another 
*0UTPUT  or  *SWITCH  card  is  expected.  The  next  simulation  will  begin 
with  another  *SIM  card. 
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A  typical  simulation  with  all  internal  control  cards  appears  in 
Figure  A-2,  depicting  a  single  simulation  run.  While  these  internal 
cards  are  uniform,  external  control  cards  are  unique  for  each  site. 
The  job  control  cards  necessary  to  use  the  CDL  program  stored  in  a 
given  system  must  be  obtained. 
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Figure  A-2 ,  Simulation  with  Control  Cards 


STANDARD  OPERATORS 


SYMBOL 

FUNCTION 

EXAMPLE 

EXPLANATION 

1 

(apostrophe) 

Complement 

A’ 

Logical  NOT  a 

(equal  sign) 

Replace 

A=B 

Contents  of  A  are  replaced  by 
contents  of  B 

(dash) 

Concatenate 

A-B 

Contents  of  A  and  B  are  placed 
side  by  side 

+ 

(plus  sign) 

Logical  OR 

A+B 

Bit  by  bit  OR,  where  A  and  B 
must  be  conformal 

* 

(asterisk) 

Logical  AND 

A*B 

Bit  by  bit  AND,  where  A  and  B 
must  be  conformal 

.EQ. 

Equality 

function 

A .  EQ .  B 

Gives  *1'  if  A  and  B  are  equal, 

'O'  if  not 

-NE. 

Inequality 

function 

A.NE.B  Gives  '1*  if  A  and  B  are  unequal, 

'O’  if  they  are  not 

SPECIAL  OPERATORS 

.ERA. 

Exclusive  OR  A. ERA .B 

Exclusive  OR  of  A  and  B 

-ADD. 

Sum 

A.  ADD.  B 

Algebraic  sum  of  A  and  B,  with 
overflow  bit  discarded 

.SUB. 

Difference 

A. SUB  .  B 

Algebraic  sum  of  A  and  NOT  B, 
with  overflow  bit  discarded 

•COUNT. 

Increment 

A. COUNT. 

Adds  1  to  A,  with  overflow  bit 
discarded 

.LT. 

Magnitude 

A.LT.B 

Gives  ’1’  if  algebraic  conditions 

•  LE. 

operators 

A.LE.B 

(less  than,  less  or  equal,  greater 

•  GE. 

A.GE.B 

or  equal,  greater  than)  are  met, 

.GT. 

A.GT.B 

'O’  if  they  are  not  met 

Table  A- 1 . 

Standard  and 

Special  Operators 

APPENDIX  A- 1 


CDL  SIMULATOR  PREPROCESSOR 
USER'S  MANUAL 


This  manual  is  designed  to  present  the  rules  and  constructs  governing 
the  operation  of  the  preprocessor  option  of  the  CDL  simulator  program 
Corresponding  information  on  the  features  of  the  simulator  itself  is 
contained  in  the  basic  user's  manual.  Familiarity  with  the  simulator 
is  assumed  for  the  reader  of  this  manual. 
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PREPROCESSOR  USER'S  MANUAL 


Format 

The  standard  unit  of  input  to  the  preprocessor  is  the  card  image. 
The  preprocessor  is  written  in  FORTRAN,  a  language  with  limited  bit 
manipulation  capabilities.  The  card  image,  therefore,  must  be  highly 
structured.  It  consists  of  a  number  of  fields,  some  of  which  are  op¬ 
tional.  Violation  of  the  format  will  result  in  a  printed  error  message 
and  a  termination  of  the  processing  at  the  next  logical  break  point. 

Assembler  Options 

The  first  information  given  to  the  preprocessor  must  be  the  user's 
choice  of  the  available  options.  The  first  card  of  the  load  module 
contains  three  fields.  The  first  field,  columns  2  through  5,  must  con¬ 
tain  the  directive  "ASM"  in  order  to  invoke  the  assembler.  The  second 
field,  columns  6  through  9,  contains  the  assembly  language  option.  The 
original  version  of  the  preprocessor  responds  only  to  the  choice 
"8080"  which  invokes  the  Intel  8080  assemb ly language .  The  growth  op¬ 
tion  to  alternative  languages  is  provided  in  the  preprocessor  code. 

The  third  field,  columns  14  through  17,  is  reserved  for  the  name  of  the 
memory  device  where  the  object  code  is  to  be  stored.  This  device  name 
must  have  been  declared  earlier  in  the  hardware  definition  portion  of 
the  simulation  program.  The  name  may  contain  more  than  four  letters, 
but  as  In  the  CDL  simulator,  only  the  first  four  are  significant. 
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The  second  card  contains  a  single  field,  columns  2  through  5, 
for  the  symbol  table  listing  option.  The  directive  "LIST"  will  cause 
the  symbol  table  to  be  printed  out  at  the  beginning  of  the  assembler 
output.  The  directive  "NOLIST"  will  suppress  the  printing  of  that  ta¬ 
ble.  As  with  the  memory  name  declaration,  only  the  first  four  let¬ 
ters  of  that  directive  are  significant.  This  card  and  the  one  follow¬ 
ing  it  are  designed  as  single  cards  to  provide  for  easy  changes  of 
those  options  that  are  likely  to  be  changed. 

The  third  card  is  the  location  counter  initialization  card.  The 
single  field,  columns  2  through  5,  may  contain  one  of  two  directives. 
"NORG"  specifies  a  location  counter  of  zero.  "ORG="  followed  by  the  ex¬ 
pression  beginning  in  column  6  will  set  the  location  to  the  value  of 
that  expression.  The  expression  is  delimited  by  the  first  blank  en¬ 
countered.  This  card  is  followed  by  the  assembly  language  program. 

Assembly  Language  Program 

The  standard  line  of  the  assembly  language  program  is  of  the  form: 

label:  opcode  operand,  operand  ;  comment 

The  first  field  of  the  card  image  is  the  label  field.  This  optional 
field  begins  in  column  2.  It  may  contain  a  maximum  of  six  alphanumeric 
characters,  the  first  of  which  must  be  alphabetic.  The  field  termi¬ 
nates  with  a  colon. 

The  second  field  is  the  opcode  field.  This  required  field  begins 
in  column  10.  It  contains  a  maximum  of  four  alphabetic  characters, 
terminating  in  a  blank.  The  contents  of  this  field  must  match  the 


mnemonic  opcodes  stored  in  the  assembly  language  table  being  used  by 
the  assembler  or  an  error  will  be  generated. 

The  third  field  is  the  operand  field.  This  field  may  be  required 
based  on  the  requirements  of  the  preceding  opcode.  The  field  may  con¬ 
tain  alphanumeric  characters,  labels,  or  expressions  terminated  by  a 
blank.  There  can  be  no  embedded  blanks.  If  two  operands  are  required, 
they  are  separated  by  a  comma. 

The  fourth  field  is  the  comment  field.  It  begins  immediately  af¬ 
ter  the  blank  terminating  the  operand  field.  If  there  is  no  operand 
present,  it  begins  in  column  22.  While  no  delimiter  is  required  to 
separate  it  from  the  preceding  text,  a  semicolon  is  suggested  to  im¬ 
prove  readability.  The  line  must  end  by  column  72. 

An  entire  line  of  comment  can  be  entered  in  the  place  of  a  line 
of  program  code  by  inserting  an  asterisk  in  column  1.  The  following 
line  receives  no  processing. 

Data  Types 

The  assembler  supports  six  basic  data  types.  The  format  of  each 
is  specified  as  follows. 

Decimal  data.  Each  decimal  number  contains  only  numerics. 
Examples:  14,  17. 

Hexadecimal  data.  Each  hexadecimal  number  must  begin  with  a  nu¬ 
meric  digit  and  must  be  followed  by  the  letter  H.  Examples:  9B7H, 
OAFH. 

Binary  data.  Each  binary  number  must  be  followed  by  the  letter 


B.  Examples:  1101B,  011B. 
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Octal  data.  Each  octaL  number  must  be  followed  by  the  letter  0. 
Examples:  720,  550. 

Character  data.  Character  data  may  be  introduced,  mainly  via 
the  DB  or  DW  pseudo-ops.  Data  strings  must  be  delimited  at  both  ends 
by  single  quotes.  Further  coding  rules  3re  included  in  the  discus¬ 
sion  of  the  DB  and  DW  directives.  Examples:  'HELLO',  'CHAPTER  2'. 

Expressions.  Only  simple  expressions  involving  addition  and  sub¬ 
traction  are  supported  by  the  assembler.  Mo  leading  minus  signs  or 
embedded  blanks  are  permitted.  Mo  special  delimiters  are  used  for  ex¬ 
pressions,  which  are  terminated  by  the  first  blank  encountered.  Label 
data  may  be  used  in  addition  to  numeric  values.  Numeric  data  alone  is 
considered  as  a  simple  expression.  Examples:  LABEL+3,  14,  SUM-2+TAX. 

Pseudo-ops 

The  assembler,  in  addition  to  machine  operation  codes,  supports 
certain  pseudo-op  codes  or  assembler  directives  which  control  the  as¬ 
sembler  as  it  generates  object  code.  The  mnemonics  for  these  direc¬ 
tive  commands  are  included  in  the  operation  code  table  of  the  prepro¬ 
cessor,  with  a  flag  that  identifies  them  as  pseudo-ops  and  transfers 
control  to  a  routine  performing  the  necessary  functions.  These  func¬ 
tions  are  of  several  types. 

Data  definition.  The  DB  (Define  Byte)  and  DW  (Define  Word)  di¬ 
rectives  define  data  to  be  entered  into  storage  locations.  DB  stores 
data  as  eight  bit  values  in  consecutive  storage  locations.  The  oper¬ 
and  of  this  directive  may  be  either  an  expression  or  a  string  of  char¬ 
acter  data.  The  expression  must  be  able  to  be  represented  by  an  eight 
bit  value.  A  text  string  may  contain  up  to  a  maximum  of  sixteen  char- 
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acCers  and  will  be  stored  as  the  numerical  code  equivalent  of  the  in¬ 
dividual  characters  in  succession.  The  DW  directive  stores  data  as 
a  sixteen  bit  address  in  two  bytes,  least  significant  byte  first.  The 
operand  may  be  either  an  expression  or  a  text  string.  The  expression 
must  be  able  to  be  represented  by  a  sixteen  bit  value.  The  text  string 
may  contain  up  to  sixteen  characters. 

Memory  reservation.  The  DW  (Define  Storage)  directives  reserves 
a  number  of  successive  bytes  for  data  storage.  The  operand  is  an  ex¬ 
pression,  the  value  of  which  determines  the  number  of  bytes  reserved. 
The  contents  of  the  spaces  are  unchanged  by  the  operation  and  are  not 
predictable  without  specific  initialization. 

Assembler  termination.  The  END  directive  identifies  the  end  of 
the  assembly  language  program.  It  causes  each  pass  of  the  assembler 
to  terminate. 

Symbol  definition.  The  EQU  (EQUal)  directive  assigns  a  value  to 
a  label.  The  expression  in  the  operand  field  is  evaluated  and  the  re¬ 
sulting  value  assigned  to  the  label  preceding  the  directive. 

Location  counter  control.  The  ORG  (ORiGin)  directive  sets  the 
location  counter  to  the  value  of  the  expression  in  its  operand  field. 

Output.  The  output  of  the  assembler  is  hexadecimal  object  code 
and  its  associated  hexadecimal  location  counter  for  each  input  line. 

The  output  is  of  the  form: 

location  counter  code  text  of  source  line 
The  symbol  table,  if  requested,  is  presented  prior  to  the  assembled 
output.  The  preprocessor  then  reformats  the  assembler  output  into 
card  images  compatible  with  the  CDI.  simulator  loading  subroutines  and 
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initiates  the  loading  process.  The  card  image  data  is  loaded  directly 
into  the  simulator's  storage  area  by  the  program.  The  card  image  out¬ 
put  is  also  printed  for  reference. 

Error  Handling 

The  design  philosophy  for  error  handling  in  the  preprocessor  is 
to  process  the  maximum  amount  of  information  possible  in  spite  of  re¬ 
cognized  errors,  without  propagating  those  errors.  Thus  errors  in  the 
assembly  option  cards  normally  cause  termination  of  assembly  after  the 
printing  of  the  appropriate  error  message,  because  the  effects  of  the 
errors  on  subsequent  processing  is  unknown.  The  exception  is  an  option 
with  a  default  value,  such  as  the  listing  and  origin  options,  where 
recovery  is  made  by  assuming  the  default  value.  Within  separate  passes, 
processing  is  controlled  by  an  error  count.  Pass  one  results  are 
printed  and  assembly  terminated  only  if  there  have  been  errors  in  the 
format  of  the  program.  Pass  two  errors  are  generally  syntax  errors, 
which  result  in  the  printing  of  the  appropriate  error  messages  with 
the  output  and  a  termination  of  the  preprocessor  reformatting  and 
loading  sequence.  The  net  effect  of  the  design  philosophy  is  to  flag 
as  many  errors  as  possible  in  a  single  run  of  the  simulator,  thus  mini¬ 
mizing  the  total  number  of  runs  necessary  to  correct  a  program.  This 
efficient  interface  to  the  operator  is  a  visible  benefit  of  the  pre¬ 


processor. 


M 


APPENDIX  A- 2 
ERROR  CODES 


Errors  encountered  in  generation  or  running  of  the  simulator  are  iden¬ 
tified  by  a  seven  character  code.  This  appendix  lists  these  diagnos¬ 
tic  codes  and  their  associated  meanings. 
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TRANSLATION  ERRORS 


CDL1001 

CDL1002 

CDL1003 

CDL1004 

CDL110I 

CDL1201 

CDL130I 

CDL1302 

CDL1303 

CDL1401 

CDL1402 

CDL1403 

CDL1404 

CDL1501 

CDL1502 

CDL1503 

CDL1504 

CDL155I 

CDL1552 

CDL1553 

CDL160I 

CDL1602 

CDL1603 

CDL1701 

CDL1702 

CDL1801 

CDL1802 

CDLI851 

CDL1852 

CDL1901 

CDL2001 

CDL2101 

CDL2102 

CDL2103 

CDL2104 

CDL2105 

CDL220I 

CDL2202 

CDL2203 

CDL2301 

CDL2401 

CDL2402 

CDL2501 

CDL2502 

CDL2601 


MISSING  HEADING  STATEMENT 
INVALID  STATEMENT  CONTINUATION 
UNRECOGNIZED  STATEMENT 

EXCESSIVE  STATEMENT  LENGTH  (MORE  THAN  250  TERMS) 

SYNTAX  ERROR  IN  ‘HEADING  STATEMENT 

UNRECOGNIZED  DEVICE  DECLARATION 

MISSING  COMMA  IN  REGISTER  DECLARATION 

INVALID  VARIABLE  NAME  IN  REGISTER  DECLARATION 

INVALID  REGISTER  SIZE  FORMAT 

MISSING  COMMA  IN  SUBREGISTER  DECLARATION 

GENERAL  SYNTAX  ERROR  IN  SUBREGISTER  DECLARATION 

UNDECLARED  OR  INVALID  DEVICE  REFERENCE  IN  SUBREGISTER 

DECLARATION 

INVALID  REFERENCE  REGISTER  BIT  STRING  DEFINITION  IN  SUB¬ 
REGISTER  DECLARATION 
MISSING  COMMA  IN  MEMORY  DECLARATION 
GENERAL  SYNTAX  ERROR  IN  MEMORY 

INVALID  BIT  STRING  DESIGNATION  IN  MEMORY  DECLARATION 
UNDECLARED  REGISTER  OR  INVALID  DEVICE  TYPE  IN  MEMORY 
DECLARATION 

MISSING  COMMA  IN  BUS  DECLARATION 

INVALID  VARIABLE  NAME  IN  BUS  DECLARATION 

INVALID  BUS  SIZE  FORMAT 

MISSING  COMMA  IN  DECODER  DECLARATION 

GENERAL  SYNTAX  ERROR  IN  DECODER  DECLARATION 

UNDECLARED  OR  INVALID  DEVICE  NAME  IN  DECODERDECLARATION 

SYNTAX  ERROR  IN  CLOCK  DECLARATION 

TWO  CLOCK  DECLARATIONS 

MISSING  COMMA  IN  SWITCH  DECLARATION 

SYNTAX  ERROR  IN  SWITCH  DECLARATION 

MISSING  COMMA  IN  LIGHT  DECLARATION 

SYNTAX  ERROR  IN  LIGHT  DECLARATION 

SYNTAX  ERROR  IN  TERMINAL  DECLARATION 

SYNTAX  ERROR  IN  BLOCK  DECLARATION 

SYNTAX  ERROR  IN  'DO'  STATEMENT 

INVALID  OR  UNDECLARED  DEVICE  NAME • 

SYNTAX  ERROR  IN  CONDITIONAL  MICROSTATEMENT 

UNDECLARED  OR  INVALID  DEVICE  REFERENCE  IN  MICROSTATEMENT 

INVALID  USE  OF  CONSTANT 

A  BLANK  LABEL  MAY  APPEAR  ONLY  IN  AN  'OPERATOR1  OR  'SEQUENCE* 
PROGRAM  WITH  ONE  OR  TWO  ARGUMENTS 
SYNTAX  ERROR  IN  LABEL  STATEMENT 

UNDECLARED  OR  INVALID  DEVICE  NAME  IN  LABEL  STATEMENT 

SYNTAX  ERROR  IN  EXPRESSION 

SYNTAX  ERROR  IN  DECODING  EXPRESSION 

INVALID  OR  UNDECLARED  DEVICE  REFERENCE 

INVALID  OR  UNDECLARED  DEVICE  NAME 

SYNTAX  ERROR 

SUBSCRIPT  IS  NOT  A  CONSTANT 
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CDL2602  LENGTH  SPECIFIED  EXCEEDS  72  BITS 

CDL2603  SYNTAX  ERROR  IN  SUBSCRIPT 

SIMULATION  ERRORS 

CDL500I  INVALID  CONTROL  STATEMENT 

STATEMENT  IS  IGNORED,  SIMULATION  CONTINUES 
CDL5I0I  SYNTAX  ERROR  IN  “OUTPUT'  STATEMENT 
CDL5102  INVALID  OR  UNDECLARED  DEVICE  NAME  IN  OUTPUT  LIST 
NAME  IS  IGNORED,  SIMULATION  CONTINUES 
CDL5201  SYNTAX  ERROR  IN  “LOAD1  STATEMENT 

CDL5202  INVALID  OR  UNDECLARED  DEVICE  IN  “LOAD*  STATEMENT 

CDL5301  MAXIMUM  LABEL  CYCLES  TO  BE  SIMULATED  NOT  SPECIFIED 

100  ASSUMED,  SIMULATION  CONTINUES 

CDL5302  LABEL  REPITITION  COUNT  NOT  SPECIFIED  IN  “SIM1  STATEMENT 
3  ASSUMED,  SIMULATION  CONTINUES 
CDL5303  AMBIGUOUS  LABEL  EXPRESSION 

CDL5304  ERROR  IN  MICROSTATEMENT 

CDL5305  ERROR  IN  LABEL  EXPRESSION 

CDL5306  ERROR  IN  SWITCH  LABEL  EXPRESSION 

CDL5401  UNDEFINED  OPERATOR  ENCOUNTERED  DURING  SIMULATION 

CDL5402  VARIABLE  LENGTH  OF  MORE  THAN  64  BITS 

CDL5403  MEMORY  ADDRESSING  ERROR 

CDL5404  INVALID  STORE  REFERENCE  OR  COMPLEMENT 

CDL540S  INVALID  USE  OF  STANDARD  LOGICAL  OPERATOR 

CDL5406  INVALID  OR  UNDEFINED  OPERATOR 

CDL5407  INVALID  USE  OF  SUBSCRIPT 

CDL5408  INVALID  PARALLEL  SEQUENCE  CALL 

CDL5409  INVALID  CONDITIONAL  TRANSFER 

CDL5410  ERROR  IN  SEQUENCE  TRANSLATION 

CDL5501  OPERATOR  LISTED  IS  INVALID 

CDL5601  INVALID  STORE  REFERENCE 

CDL5602  INVALID  OR  EXCESSIVE  LENGTH  OF  VARIABLE  TO  BE  STORED 
CDL5701  SYNTAX  ERROR  IN  'SWITCH'  STATEMENT 


APPENDIX  B 


SIMULATION  OF  INTEL  8080  MICROPROCESSOR 
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TERM  1  Nil  t 

OECOOER, 
SWITCH, 
BLOCK, 


SFLO*AOPOIOI  ,SFlt=AnPOt  ll.CSLO 
WRL  C*N ION 

CSETIO-  7)*CW0R0I  3-11 
INI Tl OFF ,0NI .INOATAI OFF, ON  I 
'  1 1 F  I  C  S  cT  I  0  )  I  THEN  IC? 

IF  t  C  SET  I  ill 


AOPO  I  21  , ROL0*N I  OR , 


SETC 


IF 

IF 

IF 

IF 

IF 

IF 


(CSET(2n 
ICSETI  31 } 
ICSETUIl 
ICSETI 51  » 
ICSETI6)  I 
ICSETI 71) 


THEN  ICPORTIO) 
THEN  (CPORT(l) 
THEN  (CPORTI2) 
THEN  CPORTI3J 
THEN  (CPORTUI 
THEN  (CPORTI5I 
THEN  I C POP  116) 
THEN  ICPORTtT) 


1, INT8-1 > , 
I.IRFB-lt, 
l,INT3=ll, 
l,INTR*lt, 
t « I NT2- 1 1 » 
l , I BF  A*  I )  , 
’1.1NT1=1). 
»l ,ORFA*l)  I 


BLOCK,  RETC  I  tF  ICSETI 0)  I  THEN  I C POR T 1 01  * l , I  NT  8*0 1 , 
IF  ICSETIlll  THEN  I C POR Tit ) *0 , l BF8  =  0 1  , 
F  (CSET| 2  1 1  THEN  (C PORT | 2 |*0, I NT3*0 I , 

0 , | NTR  *0 j , 
0, INT2*0», 
*0,1 BFA*Of , 
*0, INTl*0| , 
0,0BFA*oM 


ICSETI  11) 

iEiinr 

IC  SET  I  4 
ICSETI 5 
IC  SET  I  6 
ICSETI 7 


THEN  I C  POR  Till* 
THEN  (C  PORT  1 21* 
THEN  C POR T 1 3 1  * 
THEN  C POR  T I  4 1 > 
THEN  CP0RTI51 > 
JHEN  C  PORT  ( 


ICPOR 


Ml: 


BUS,  NUMBER  I  2-0 ) 

MEMORY,  INPUTINUM8)* INPUT! 0-7, 7-0) 

"  ‘  . *«  - 


CONTROL  FUNCTIONS 


•  •• 
«*« 
♦  «* 


8080  CONTROL  FUNCTIONS 

/RESET*PIOI/  MLTA*0,WAIT*O,REAOT*l*PC*0,X*&,Y*6 

/SYNC*P  I 01  /  OATABUF-MEMR-INP-MI  1 1 -OUT-Hl  TA-STACR-NWO- 1  NT  A ,  STS  t  R»(J, 
SYNC-0 


8228  CONTROL  FUNCTIONS 


/STSTR'PPI 11/  STAT=DATA8UF,NMR=IDBJN»MEMR) 
N) OR* | 08  IN* INP) • ,N10W* ( NNR ' *OUT  I 


^MW.INWR’POyt'  I 
,NINT»ID8!N*|NTA)*,STSTR*I 


/NI1)*TI3I»P(  l ) ‘READY* I  NT  A/  IR*:FF 


M 

»* 

M 


UTILITY  BOUJINFS 


START  SWITCH  AND  EXTERNAL  INTERRUPT  SWITCH 

/I  NT  ST  ION)/  A*0,PEA0Y*I.X*8, Y*6,NN0*l,NMR*l,NMR*r,NNW*l ,NIOR=l ,NIOW*I, 
NINT*I,STSTR*I 
/SU I  NT  I  ON  I /  INT-|,SWINT*nFF 

MEMORY  RF  AO  CYCLE 

/OBIN*NMR<*PIO)/  ACmEM*A0P8UEEPR 

/OB  IN*NMR*  »P  (  |  )/  OAT  A0  *ME  Ml  AOME  I  ,RF  AOY  =  |  ,DR|N*0,MEMR -Cl  ,NMR  =  l 
C 


nnn  no o  non  non  non  non  nnnnnnnnn  non 


69 


/Ml  3  MTU  I  »PI  t  I  *REA0Y*MR2/  ADD8UFF  ER  =  A 14  TCH, 
SYNC=lf08IN=l.REAnY=0,HfHR=l 
/Mm*n2l*Pm*RE»OY«MR2/  MR2=Q 

NRITE  BYTES  INTO  MEMORY 

/T(tl«P(  t  »»MWl*READY/  ADOBUFFER^ALATCH, INTFRNAL- 
SYNC = l ,NWO*0 ,REAOY*0,NWR=0 
/T(2»*PUI»MWl*READY/  MWI*0 


TEMP, 


8255  CONTROL  FUNCTIONS 


SWITCHING  OPERATIONS 

/INI Tl ONI/  ADPOt 2l*l,CPORT(2 I  =  1 , CPORTU I  * l  ,CPOR T I  6 1  *  1 .STB  A*  l , 
ACKA*l,ST88=t,IN!T=0FF 

/Inoat a i on j/  stba=o,apcrt* inpu( number! . number* number. count. , 

PORT  101 -1NPUI NUMBER  1 , INOAT  A* OFF 
RESET 

/RSET»P( 11/  CWOR0*0, I  NT  1  =  0, I  NT 2«0, 1 NT8* 0 
STROBE  ACTION 


/STBA'PPIll/  C  POR  TI4)»0»l9fA*J ,  CPOR  T I  5 1  •  1 
/ST8B**P|  11/  CPORTI  21=0, 1 8F 8=  l , CPOR T I  11*1 
/STBA'«I8FA«P(0»/  S  T8A  =  i 
/STRB'MBFBAPIOI/  STBB*1 
/ACKA,*08FA,*P(0I/  4CK  A*  t ,  CPOR  T I  61  *0 


INTERRUPt  LOGIC 

/I IBFA»STBA' •INT2«ROLOI»IOBFA' »ACRA<  *|NTl»WRLOI«Ploi /CPORTMI*!, INTR-I 
/IBFBPSTBB'AINTJPRDLQAPI 0)/  CP0RT(0I*1,INTP=1 
/UNTRUNI8I*PU>/  INT=l 
/IINTR*INT8I*INT*PI1I/  I N TR  =  0, I N TB*0 


BIT  SET/RFSET  FUNCTION 

/CSLO*  *  I CWOR  0|  71*  l«CWCR0(O)»5EL0«$ELl»P<0l/  oo/setC 
/CSLO*  •  I  CWOROI  71  •  MICWCROI  01  •  I  *SF10«  SFLI*PI  01  /  00/RETC 

OUTPUT  TO  8255 

/CStO'«WRLO'*SEtO*SELI»P(  11/  CWORD=0ATA8 
/CSLO’ •WRLO,*SELO**SEL l'»P| 11/  A  PORT -DA  TAB 
/CSLO’AWBLO' ASElOASEll *AP( l »/  8P0R  T  =  QA  TAB 
/CSLO*  »WRLC"«SFLO,«SEL  l»P<  II  /  C  PCP  T  =  OA  TAB 

INPUT  FROM  8215 

/CSLO’PROLO'RSEI  0'*SFL  l '  *P  I  1 1  /  OA  TAB*  A  POR  T 
/CSLO' •RPLO' »SF10*SFL  l  •»PI  1 1/  OATAB=BPCRT 
/CSLO*»RPLO'»SFtO**SEL  l»PI  I  »/  HA  TAfUTPORT 
C 

C  INPUT  ANO  OUTPUT  TERMINATION 
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c 

/( si. o'  *p ( ') i /  a :>i*o i  ? i * i 

A»  »* 

«♦  I  M  F  L  P0P0  INSTRUCT  [CN  SET  »• 

A*  A* 


aoi  ac  i  sut  s«t  an  f  xm  nm  cpi  hvi 


/M<l)AT<AI‘P(l|'RrADY*(lR<7t.tR».|R(6ll’*OP3(M/  A  l  ATC.H  =  PC  i 
PRl  =  liX-0»  V- 2 

/Ml  2  I  *M  21  AP  II  |*R  E -Atm  I  IRI  7)  .r  RA  .l  R(  61  I  •*  CP3(  M  /  MR  1  =  0 
/HI  2  J  ^  1  T  3  I *P  (  1  I  *  R  E  A  U  Y  •  I  |R(  71  .1  RA.  I  R  I  (,))  '  *'JP  ?(  61  /  RC-AI  AICH, 
TEMP  •  HAT  AINIF  ,  I  Rl  6  M  I  R  I  6)  •  ,  X- A  ,  Y  - 1 


RE  C  RRC  RAL  RAR 


/Ml  1  «t  (  A) API  1  I »RE AQy*ooi (ol  MlPAI 7) /  X- 0, Y  =  1 

/Ml  l  I»  I  I  Al  »P  I  1  i*RE  ADY*'JP1  (  01  *01 V  I  01  «|P  }(  7  I  /  4=6(6-01-4(7), CARRY*A(71 
/M(  1  |  at  (  A)  API  n*P  E  AOYAQPl  I  J  /  I  l  )  A, !p  1111/  A  A  |  0)  -  A  I  7  1  I  ,  t  APR  Y  A(  01 
/M(l|AT(AI»P(ll»REAOYAL)Pl(0)AUP/IPI*Iip3iri/  A-4|60)-C7,R°Y,CARRY  =  Af7l 
/Ml  I  l*T  I  A  I  *P|  l  I  ARE  Ai)Y*nr  l  I  OIMIPPI  3)  *I)P  A I  71  /  AEARRY  A(7-I!,CARRY-AI0I 

D  A  A  CMA  STC  CMC 


I r  (CY1I  THEN 
I  A  (  3  -  Ol  .r.F.  I  01 


THEN 


/M(  I  I  AT  I  A  I  API  1  |  *R  f  ATYAflPl  I  II  A  OP?  I  p  )  A  OP  7|  7)  / 

I  A-A.AD0.6. INTE-A.A00.6i  :  I  S  E  I  ]  F 
I  A-A.ADD.6t  INT F -A .ADD. 61  I 
/Ml  1  l»T  I  5  I  API  l  I  are  A  D  Y  •  0  P  l  I  !  I  AOP/I  OI»OP  51  71  /  M  7.0  5-  t , X -0, Y' 1, 

IF  |  CARRY. FO. I  I  THEN  I  A- A.  A  HD.  At  ,  I  NT  r  A.  A  n,.->6  |  f.  (  SE 

(IF  (  Al  7-AT.GF.  101  then  |  a  -  a  .  A'.n. '-F.C  ar  r  y  i  ,  I  N  i  r  -  A  .  ADD.  R6)  i  ese 

I  IF  ( A(  7- A  )  .FQ.NI  THFNIIF  IA(  70I.GE.10I  IhFn 
(A-A.AD0.D6,CARRYM,INIE-A.ADr.'Tt)m 
/M(  1  T  *  I  (Al  *P(  1  l*READY*OP|(  l  1  *  0  P  P  I  0  I  *  *  ‘  I P  3  l  71/  »^,YM 
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MOV  ML T 

/M(  1  I  »!  |  4  |«  p  I  l  1  »R  I  APY*  I  R  I  7  I  '  »  1  R  I  6  I  /  IF  I  PP  l  I  3  I  *  HP  2  1  2  I  *  L  P  3  I  A,  ||  Tl|r-N 

I  ML  T  A  -  1  ,  X -  Ot  Y  2  I  1  l  SF  I’O/SrVALI 

/M(  I  )  «  I  |  5  1  *  P  (  1  )  *P  I  AMY  •  IR  I  M  *  *  I  R  I  f  1  *  MRI  F  •  /  P'  /'M  V4L 


l  )  M 

1  «.  J 

♦PI 

)  ♦  p  1 

Ar)  Y  ♦ 

IM/I1 

1  *  1  w  (  )  ♦ 

MR 

f  F 

/  X  3,Y-7 

/“<?)♦  \ 

(  L  ) 

1 

I  •  Ht_ 

1  A ♦ R  F  V) Y / 

^YNC  1  y 

HF 

MR  ' 

l 

/*{  2)  M 

i  2  ) 

•PI 

1 *HL  1  A/ 

WAIT] 

i . «i  ai;y  = 

0 

l  2  ) 

♦  P  1 

1  *R  1 

AO  Y  ♦ 

Ml  T  A  *  < 

►  i  im  7  r  • 

I  R  I  M 
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2  1  *  l 

l  U 

♦PI 
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AOY* 
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1  ♦  1  p  1  6  I  ♦ 

CP 
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1-H 

Af)Y* 
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1  *  1  0  (  M  • 

l)F’ 
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MR  OCR 

/SI  1  )»  T I  4 )  »P  I  1  l«RF  APY«  IP.I  7  I  •»  IP  t  f,\  *  'Pi’ll  4)/ 

IF  (UPDIOI)  1HEN  IE  R. COUNT.,  MIC  -Q.CnUNT.lt 
if  (nrnmi  then  ic  =  c.c<'unt.,  inte^c. count.  I. 

IF  (r)P0(2l)  IHFN  I  0  O.UIUNT.  .  I  Nl  r -n.(  IJHNF.  I  ,  • 

IF  I  UP  D I  3  1  j  THEN  < E=F. COUNT. , I NIE=F. COUNT. i , 

I  f  (|!IM>(4)i  THEN  (  H  =  H.(  HUNT.  ,  I  NT  E  -M.l  piimT  .1  , 

IF  ( U P 0 1  5  I  I  THEN  IL  =  l .ruUNI. , I N1E-I  -COUNT. I ,  , 

IF  lord  4  I  I  THEN  I  MR  E  F  = 1  ,X=0,Y=2I  EISF  I X-0,Y-ltEL4GS-ll» 
IF  (OPDIMI  THEN  ( A» ». COUNT. . I NTE  = A.C OUNT. I 
/M<ll*T(4l*P(ll*REAr)Y*1Rl7I,*[R(6>'*  OP  3 151/ 

IF  mPOIOn  THEN  (B=P.SUP.1,1NIE  P-SUR-IT, 

IF  (EIPMl))  THEN  (C  =  C.SUB.  I,  IN1f=C.S'J?-l  . 

IF  I  OP  IM  2  I  j  THIN  (0=0.  SU3.  I ,  I  NT  F  f).  SUE  .  1  (  , 

IF  (  El  P  [)  I  3  )  )  THEN  i c=e.sub. i , tnte=f . sun. i i , 

/HI ( ) *T ( 4  I *  P  I 1 ) *  R  E  AO  Y* IE  I  71 ' *1 R( 6) 1  *  OP  3  I 51/ 

IF  (Ufl)(/.n  THEN  I  H=H.St)fl.  1  ,  I  NIC  =H.SU8.  t)  , 

IF  I  OP  0 1  5  j  j  THEN  j  L  =  t  .SUfT.  1 ,  I  NTE  =  I  .  SUP.  1 1  , 

IF  ( 0  P  0  T  6  I  I  THEN  MR  £  F -- 1  ,  X  *  0  ,  Y  =  2  )  I  L  S6  I  X  -  0  ,  Y  U  ,  Ft  AC  S  =  l  I  , 

IF  (UPDI7II  THEN  i A  = * . SuB. 1 , I NI E = A . SUP . I) 

/Ml  2  I  ♦  1  I  2)  »PI  1  I  *RE  A!)Y*  1RT  7  I  •  ♦  I  R(  61  *»  (0P3T4  I  «CP3(  5|  1  /  uf.lE»0 

/HI  2  I  •  T  C  31  »P  I  I  I  *R(  AUY*  |R  1  7  i  •*  IRI  6)  (UP3(  41  ♦IIP31  5)  I  /  X  0, Y=3« 

IF  l  (IP  3  I  4  I  )  THEN  I  1EHP  =  0&TAPUF. FOUNT,  i 
USE  I T I PP=0A1 ABUF.SUP. I ) , MSI =! , ACA ICHUI-L 
/K(3l‘M3)*P(ll*RFtDYMR(7),»lR<6l*‘IUP3(4)<tj.~3l5IT/  X=0,Y=I,F|AGS=1 

PUSH  n  PUSH  0  PUSH  H  PUSH  PSM 


/HU  |*  I  I  4  )  *P(  1)*R  E  40Y*(0P1 1  6)  *UP1  I  I)  )  ‘  lor  /  I  1 )  '  I  *0P  31  51  /  Al  ATCTI-SP.SUft.  1  , 
X-OtY=2,Mwl=!,STACK=l 

/HI  l  )  *|(  4  I  *P  I  1  *R  FADY»CP(  I  61  »(.'P2  I  0)  *1031  SI/  TfSP  =  B 

/H|[  )  »T  I  4  I  *PI  1 1  »PF4(IY*UP  1  I  6l  *UP2I  2  I  ‘III  31  5)  /  1  [  s  P  -  0 

/HI1)»1I4)PP(1)»REAI)Y*(;P1(  7  I  »UP2I0I  I  51  /  T  I  MP--H 

/HI  1  1*1(41  *P(  II  *  R  [  A  UY  »(JP  1  I  7  J  »UP  ?  (  2  )  *131  51/  TEMP  -» 

/Ml  2)»T  I  31  *P  I  1  )*W!  AOY*  I0P1  Ml  ♦HP  I  (  7 )  )  •  U;P7  t  1  I  ■  I  *  UP  3  I  S  l/AL  ATClO  SP.SUB.2, 

X  =  0  ,  Y  =  3  ,  H  H  l  ■=  1 

/M(2)*T(  3  )  *  P  I  I  I  *  R  f  /-  0  Y  ♦  I  i  P  I  I  6  1  *  (i  P  2  I  0  )  •  UP  3  (  51/  lrMP< 

/HI  2  j  *  T I  3  j  »P  I  1  l»R  f  Al-Y  *  li"  I  I  '.  |  »i;P2  I  2  I*  UP  31  51  /  1  f  MP  =  F 
/H  I  2  I  *  T  j  3  )  *  P  I  l  )  *!•  L  A;y  »(!P  1  (  7 1  *'JP  2  I  j  I  *  .13(5)/  I:  “P=L 
/HI  2  |  •!  I  1)  *P  I  1  I  *R  E  All  U  OP  I  I  71»UP?(2)*UP3(5I/ 

T  E  HP  -CARRY  l  -  PAR  I  T  Y-O-CYI  -  0  7!  RO  -  SIGN 
/HI  3  l»T  I  3)  »P  11  T»R  E  AUY»(UP1  1 7,1  *UP  II  7)  )•  UiP?t  1 1  •  )  »  HP  31  6)  /  SP  -  SP.  Stl=».  ?, 

X -n , Y= I , ST AC K=0  , 

pup  n  pup  n  euP  i  top  psk 


/hi  |  )  »  I  (4  )  *P  (  1  )  *F  T  A"Y  *  I  DP  II  61  *r,P  1 1  7)  )  M  UP  2 1  31  "IP  2  (  21  )  •  UP  *  I  1  )  / 

7.1.  A  ICH  SR,  X-0,Y=  2  ,'JP  7  ’  1  ,  SI  .*CK  l 
/“(  3  I  *  !  I  3  )  *P  I  t  I  «R  (  AI,Y»  KIP  l  I  '.  )  <  I  P  1  (  7  )  I  M  l:P2  I  n  I  *(.P  2  I  2  I  I  •  I  P  <(  l  |  / 

SP  -  9P  .  A  U’T.  2  ,  X  0  .  Y  -  1  ,  S  I  Af.  K  =  0 

/hi  3 1  *  I  ( 3 1  «p  ( 1 1  »r  r  s:  ymipi  (  6  I  •>)"?  i  7 )  *.,p  3i  i )  /  r  i  r  ,p  -oat  muf, 

/hi  3 1  •  T I  3  I  »r  I  1  I  PR  f  AOy  ♦  up  1  I  M  •  IIP 2 1  2  )  'UP  31  ||/  r  -  T  >  “R  .  •:  v.  1  7,-Mjr  , 

/HI3  )  *T  I  3  I  *r  I  l  I  *«  f  Apr  ♦  IIP  |  I  7  I  •IIP?  10)  «IIP  II  I  )  /  l  U“P,M  f.l/.'-UF, 

/HI  3  )  *T  I  3  I  *  P  I  1  )«  PI  M1»  •  IP  !  I  7 )  *UP2  I  2  )  »HP  M  I  I  /  7.  -a  \  -  <|  .cm  I  •«.:•(  71  , 

PAR  I  I  Y  I  I  M,->  (  ■,  I  ,  (.  Y|  I  I  “  PI  I  I  .  /  ’  07'  II  “PI  1  I  ,  \  I  '■ N  null'll 

C 

r  .  ST  A  I  UA  SHI  0  I  HU) 

c 

/“.I  1  I  •  1  I  4  I  •  P  I  1  1  *R  I  Af'Y  •  I  PI  I  l  1  »UP  31  2  I  /  »  3  ,  Y  2,  M  A  If  H  i’i  ,  i  f  Pf  2, 


UUU  UUU  Ouu  Uuu 


n 


M  R  2  =  1 

/Mill  *1  (  3  HP  I  1 1  »R  FAOY»UPt  (  I  l»UP2(0  MOP  II  21/  IS  MPH  ,  Al  A  1  CM  0A  I  J  S3  -  I S  M  P, 
X0,Y-4,MWM1 

/M(  31*1  (  II  *P  (1  l*R  I  AOY'llP  I  (  1  I  *f)P?(  2l*OP.3(?|  /  T(  M  P  -  A  ,  X=>o,y-4, 

AL  A  I  CSC  PA  I.MSUr-  1 1  IP  I  MW  1  =  1 

/HI  4 J  »1  I  3) *(M  I )*RE»CY»OPl (  1MOP2I2MOP3I2)/  X  -  0,  YM 

/"<  3  Ml  I  3  MPI  !  >  *P  F  ADY*OPl  I  11  *  ll)P2i  1  MUP21  31  MOP  31  21  /  X--0,Y^A 

/M(4)*lllMlMlMRFACY»UPl(lMtOP2(IMOP2l3)MOP3<7.)/  X^2,Y=4, 

AOURUFF  CR  =  OA IA0UF-T CMP . SYNC  = 1 , OS3IN=I ,HrMR^l ,R(  ADY  =  Q 
/MI4MTI31*P|lMRFAOY*OPl(lMOP2IOMOP3(2)/  Tf  H.P*H,  Al  A  ICH- ALA  T  .COUNT.  . 
X  0,  Y=S, -W|=  t 

/M|4MTl3MPliMRS  »DY*()Pl  (  I  )  »OP2  I  1  MOP31  21/  X^O. Y=5 

/Ml  S  >  ♦!  (1  MP  I  1  MR  CAOY*OP  1  I  1  MUP2I  1  |*OP3<  21  /  L=04TA6UF,X=?fY=5, 

AOPBur F CR  =  AODPUF  ftp. COUNT. «SYNC-l.RfAPY-0.DI3lN-I , MEHR*1 
/Ml  4)  *T  (  3)  »  P  I  1  MR  I  AOVOPI  (  l  MOP  2  I  3  MUP3I  21  /  AHAIA0ur,X-0,Y=l 
/Ml  5M  H  3)  »r(  l  MR  F AI)Y*OPI  I  1  MUP2I  OMOP3I  21  /  X-0,Y=1 
/Ml  SM  I  I  3MP  I  l  MR  F  A0Y*UPH  1  MOP2I  1  MCJP312I  /  H-0ATABllF,X  =  0,«r*l  i 

01  FI  NOP 

/H(  I  M II4MP ( 1) «RT A0Y»0P1 (  7 l*OP2( ?) *OP3l ?| /  1  NT N- 0 , X -0 , Y* 1 
/MUM114MPIIMRI  Ai)Y*C,U  (  T  MUP2  (  3  M  UP  31  3  I  /  I  NFN*  I  ,  X -0, Y*  I 
/Ml  1  MM4  )  «P  (  It'll  £  AOY*DPI  (  OMOP?  IOMUP3I  Ot  /  X  C.Y^l 

PCMt  SPHt  XIHL  XCHG 

/M(l)*T(41»PU  M KFAOY* UP  I  (  7MOr2l  1  )  ♦  UP  3(1)  /  PC  H  - !  ,  X  *  0  ,  Y  -  1 
/Ml  1  *1  i  4)  *P(  1  |  *Rf  AOYM'Pl  (  7  j  »OP2(  3  )♦  OP  3  l  1  )  /  5  P  -  H-|  ,  X  x  o,  Y*  I 
i  * T ( 4MP ( 1 1*RE ADY'UPI ( 7 MOP2I l J*(jP 3  -  -  -  - 


/Ml  ll»  T  (4)*P  (  1  )*RE  AOY'llP  I  (  Tl»OP2i  1  »<j!>3<  31/  I'  -  0, 0 UI.  C  -{  ,  l -C  ,  X- 0,  Y*  1 
/Ml  1  Ml  (4)  *P(  1  I  *P  t  AIIY*  OP  l  (  7  MOP  2  I  0  I  *UP  3(  3)/  Al  A  1  ctl-  SP  ,  X  -  0  ,  Y=  2  ,  MR  2  >  1  , 
SIACK-1 

/H( 3  » *  T ( 3 ) »P(I )»RFA0Y‘0P1 I 7)‘OP2i Ol*OP3( 31 /  l  -  I  r  MP  ,  H  AT  AS3UF  ,  T  F  KP  =  H« 

W=l ,X=0,Y-4, “Wl*l 

/M(  4  I  *T(  3  I  *P(  II  *Rf  A0Y*UP1  I  7  >  *  OP  2  I  0  )  *()P  3  I  3  )  /  T  T  MP  ’W  ,  A(.  At  CH- A  PORUF  .  SUB  .  1  , 
X-0fY-5jMWL-l 

/M(  5)  *t  I  3)  »P(  1 1  «R  EAf'Y«OP(  (  7  I  »nP?(OI  »OP3l  3  )  /  X- 0  ,  Y*  1 , 5  T  AC  X  =  0 
P.  ST 

/Ml  l  )♦! ( 4 ) »P( I  1 *RF  AOY* IR(7M|R|M*UP3I71/ 

A I  A  I CH=  SP.SU9. 1 I  MW1  =  1  , SI ACK  =  I 
/MI7)»TI3MP(l)*PEAOY*IR|7)*|P|ft)»UP3(n/ 

A I  ATCH-AlATCH.SUB.l.MWl^l 
/M(  3  1  *1  I  31  •  P  I  I  I  *RF  A()Y*  IR  l  f  M  |P  I  61  *l'P  31  71/ 

pc- ;u-;u- so- so  -  so- so  -  so  ;o-:o  ;j 

CUT  IN 


x-o, Y^2, ICMP  - P r I t  F  9|, 
X-0.Y  =  3,lfMr.PC(  7-31, 


x-o,y-i,sp  *. p . sup. 

!  R  I  5  I  !  fi  I  4  I  I  R  I  3  I 


/.SlAC’O, 
: J  SO-SO 


/Ml  1  |M  I  4  I  *P  I  1  )  *Rl  AS  r*  I.l’  H  4  I  *  1 1  S’ 2  I  21  HIP,'  (  3  ll'l.r  *(  3  I  /  M  Aid'  PC  , 

PC  PC .C HUNT . , X  9, Y- 2. “0 l  =  | 

/Ml  I  )  «  1  I  1  I  »  P  I  1  J  ♦  R  S  AOY  ♦  UP  I  I  5  I  •i;f'2  I  7  1  »  UP  31  3  j  /  MP'UiJf  «  i  p  I  !  M  P  -ICMP,  OUT  -  I  , 

INI  F  -  A  ,  SYNC  ‘I  j  "  r  A  n  Y  -  0 ,  N  R  0  0, N»P  =  0 

/M|  31  ♦  I  I  I  t  »P  I  1  I  »R  r  ANY--  OP  !  I  M  »OP/  (  3  )  »()P3(  31/  AC'UiUM  <  B  I  1  “  P  -  I  r  M  P  ,  I  N  P  *  1  , 

SYNC  -  I  ,'  ? IN  1  ,4  APY  :0 

/  "  I  3  )  ‘  I  I  2  I  •  p  (  I  )  •  P  I  ANY*  IP  I  (  f>|  •  I  CP  2  I  2  I  •  OP  2  I  3  1  )  *  i  I  3  (  3)  /  1  ?  ,  Y  -  3 

/  “  I  ’  •  I  I  3 1  •  '■  11  I  •R  1  A  «Y<  :  !  1  t  '■  >  »  IP2  I  2  I  ‘UP  3(  '  I  /  »-a,y.| 

/  “I  3  )  «  t  I  3)  «P  I  !  )  *F  '  AOY  •  '  PI  I  »■)  »UP2  I  3  )  »  UP  3  I  »  1  /  *  'AlAi'.'ir.t  0  .  Y  -  1 

I  NO 

£  ||  (  i  I  »  »  M  t  M  t  H  M  I  I  I  I  I  t  I  I  t  M  t  t  M  t  M  «  «  M  I  I  I  M  I  1  I  t  I  d  !  I  H  l  l(  H  I  M  I  '  «  M 

C  •  *  *  ♦ 

C  **  I  'n  (If  M.  AN  A  !  ?UNJf  R  f  GIN  r>  I  Ml/!  A  l  J  f -N  *♦ 


75 


c  ♦* 

t  S 1 “UL A  T  E 

•DUE  PUT  UBflU,Zl  =  Y,  X,  A,  DAT  ABUF,  APDBUr  FT  R,  ]NFN,  I  NT, 

1  ?»PCj  l  lMP,srAT,CWtJRn,CPORI.  APOR  T,  INI  1  ,  I  NT  2,  I  NT  R 
♦SWITCH  '  *  ~ 

♦  SWITCH 
• SW I TCH 
♦LOAD 


"I'TiHnc,) 

1.  INt  ST  =  ON 
2 , I N I T -  ON 
75, INOATA=ON 


ASM  BOBO 

mem 

L  1ST 
NORG 

ow 

OOC  IH 

• 

ISIOREO  DATA 

ORG 

56 

INPUT: 

INTERRUPT 

handler 

ROUTINE 

PUSH 

PSW 

ISAVE  A 

MV  I 

A,  06 

IKILL  I  NT  R  SIGNAL 

OUT 

3 

MV  I 

A,  OBH 

IKILL*  I  BE  A 

OUT 

3 

IN 

0 

IRE  TR 1  EVE  INPUT  CHARACTER 

STA 

020  IH 

I S I  ORE  IT 

POP 

P  SW 

IRE  ST  ORE  A 

El 

{REENABLE  interrupt 

RET 

IRE  TURN 

(IPG 

OlOOH 

• 

MAIN 

ROUT  t  NE 

SETUP: 

El 

IFNABLE  INTERRUPT 

MV  I 

A  ,09 

I  SET  INT2 

OUT 

3 

OUT  PUT  : 

LOA 

o?oou 

ILOAD  CHARAC  T^R 

OUT 

0 

IOUTPUT  TO  PORT  A 

HLT 

ORG 

0?OOH 

DW 

'  OOC  2H 

••STORED  INFO 

FNO 

PC=!0100 
INPUT! :Ol=:Cl 
♦SIM  BOO, 3 


♦  ♦ 

•••*»*»• 


APPENDIX  C 

PREPROCESSOR  FORTRAN  ROUTINES 


nnnnm 
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cccccrccccccccccccccccccccccccccccccccccccccccrccccccccccccccccccccccc 

CCCCCCCCCC  FORTRAN  SUBROUTINE.  TITLE  :  ASMINT  CCCCCCCCCCCC 

cccccccccccccccccr.cccccccccccccccccccccccccccccccccccccccccccccccccccc 

DRIVER  ROUTINE  FOR  CPOSS  ASSEMBLER  AND  LOADER  ROUTINES 

SUBROUTINE  ASMINT  I  A,  JN  ,  Jt  ,  J2  ,  ♦  ) 

INTEGER  H33.H3A,  H4  5.H4  6,HA7IH48,H4‘»,HT3 
DATA  H  3  3*  H3 A  *  HA  5,  HA6,  HAT,  HAS.  HAN 

C  /3HASN,  3HORG i  AHLI S T , AHNONE , 4HNORG , AH8080, AH 

r 

f  OMNCN  /TABLES/  SUIT, 157, SLI3,t5>,l«l4,2!50>,CLIA», 


i  fltjLcSr  ftnr,  hi 

•  NSU, NS L » Nl B*  NCL  » NP, NST , NSV ,NP SAVE , HARP , Pf 1) 

INTEGER  SV,SU,SL,CL.P 


COMMON  /WORK/  SVISOOOJ, 181 250  I , INBl 2501 ,NSV,NfT,NTA 

COMMON  /OAT A/ IE, HOI , H02 . H03 ,H0A, H05 , H06 , HOT, HOB , HOT , HIO , Hll ,H12 

1  H21 ,H22  »H?  3 ,H2  A  »H31  #H32 / HAI ,H A2 , HA3 , HA A ,H51 , H52 ,H53 

2  H5A,HS5,H61 ,H62 ,H4 3 , H64 , HAB , H66, H67, H68 , H69, H70.H 71 

1  ,H72 

INTEGER  HOI ,H02,H03,HOA,H05,H06,HOT,HOR,H09,HIO,HU,H12, 


78 


c 

c 

c 

c 


c 

c 

c 

c 

c 

c 


c 

c 

c 


»  H71 .H22,H23,H24.H3l,H32,H4l,H42,H43,H44,H5t.H52, 

*  H53.H54,H65.H6I , H62 , H63 , H64 , H6 5 . H66 , H67 , H6B , H69, 

*  H70,H7l,H72 

INTEGER  A( 21 1. PT ABLE  I  3001  ,ST ABL E I  60 1 .CODE  116 1  .ALINE  (SO  I 

language  options 

50  WRITE  (6,51) 

51  FORMAT! •  • ,/T 

100  WRIT£(6,10II  A 

101  FORMAT!*  •,A1,19AA,A3) 

IF  IAI2l.Nr.H33l  GO  TO  2000 
IF  1AI3I.NE.H48)  GO  TO  2500 
IF  I  A I  5  J  .EQ.  H4BI  GO  TO  27SO 
"EMORY  =  A! 51 

OTHER  LANGUAGES  MAY  BE  LOAOE0  8t  INSERTING  SELECTION  LOGIC  HERE 
CALL  LOOASMIPTABLE) 

LISTING  OPTIONS 

200  IISTIT* l 
REAP! 5,2011  A 

201  E0RMATIA1 ,19A4.A3> 

WRITE  ‘ 

1  F  I  A 

IF  tAI2l.NF.H46l  GO  TO  300 
LISTIT=0 

ORIGIN  OPTIONS 

100  l COUNTS 

PFAOI5,2011  A 
WRITEf&.lOl)  A 
IF  I  AI2I.EQ.H471  GO  TO  400 
IF  IAI21.NE.H34I  GO  TO  4000 
(CRCOQ  =  l 

CALL  V  AL  PE  0  I  AI  31  .NUMVAL,  IERCC0I 
IF  IIERCOI)  .NE.  01  GO  TO  4500 
LCOONT  =  NUMVAL 

ASSFMfUY  FijPRCU’INES 

400  WR  7  TE 16,401  I 

401  f  C  nMA  T I •  ', 7, 25X, 'ASSEMBLY  BEGINS  HERE’, 71 
I E  RCN T  =  0 

CALI  PASONE  (l  COUNT.PTARLF,  IEPCNT  I 
ENO  FILE  ’ 

PFNIMI)  2 


mlOll  A 

.NE.H451  GO  TO  3000 


PRINT  SYMBOL  TABLE  IF  OFSIREO 

600  IF  UlSTir  .NE.  1)  GO  TO  600 
CALL  PR  I N t  T  ( STAOLF , IPO INT , !ER»31 
IF  <  (POINT  .EQ.  01  GO  TO  400 
WP1IF  16.501) 

601  TUPMATI*  •  ,  7  7  •  1  5  X  f  '  SYMBOL  TABLE  ',71 

LIMIT  ,  | P  O I N  f  7  4 


UUU  uuuuu  Ut’U  uuu 
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c 

s 


r. 


DO  550  I  =*  I. LIMIT,} 
tl  »  1  »  1 
12  *  }  »  2 

WRITE  16,502)  STABLE!!) 
502  format)*  • . iox,*  symbol 

550  CONTINUE 


.  STABLE!  Illi 
1,44.44.'  VALUE 


STARLEI 
E  *.241 


12) 


WRITE  PASS  ONE  RESULTS  !f  PASS  NOT  ERROR  FREE 

600  If  (I6RCNT  ,EQ.  0)  GO  TO  70 0 
WRITE  (6,601) 

601  FORMAT! •  • , / / , 25X , ' PA SS  ONE',//) 

650  R  £  ADI  2.  660*  EUO*68u  )  A 

660  FPRMAUA1 ,1944  ,431 
WRITE  (6,670)  A 
6  70  FORM  ATI*  • ,Al,19A4,A3l 
r.C  TO  6  50 

6R0  WRI TE  I  6,6001  IERCNT 

690  FORMAT!'  ',5X, 'IERCNT  »  *,141 

GO  TO  5000 


PASS  TWO  PROCESSING 

«25X, 'PASS  TWO') 


700  WR I TE  !  6,701) 

701  FORMAT!'  1 ,/ / ,2 
WRITE  (6,7021 

702  FORMAT!'  • , / /. I X , ' 1C  * .5 X , 'CODE  * • tAO* ' PP OCR  AM  STATEMENTS*./) 
CALL  PASTwO  (LCOUNT.PtABLE, STABLE, IERCNT, lISr/T) 

END  FILE  3 

IF  ( IFRCNT  .EQ.  0)  CO  TO  800 
WRITE  (6,690)  !E«CNT 
GO  TO  5000 

PREPARATION  OF  CARO  IMAGES 

INITIALIZE  FOR  PREPARING  CARO  IMAGES  FOR  LOAD  PROCESS 

BOO  REWINO  2 
REWIND  3 

900  CALL  IMAGER  (MEMORY) 

FNO  F  HE  2 
REWIND  2 

1000  WR ITE  (6,1001) 

1001  FORMAT ( •  ',//) 

SEND  RESULTS  TO  RE  READ  INTO  MEMORY 

CALL  100MEM  IJN, J1 , J2.S5000) 

WR  I  TE  (  6,  1001 1 
GO  TO  4000 

ERRTR  MESSAGE  ROUTINES 

2000  WR 1 TF  ( 6,2001 ) 

2001  FORMAT!'  MISSING  ASM  CARD 

on  in  snoo 


TERMINATING  ASSEMBLY  *•»*»•) 


2500  WR I TE  ( 6,2501) 

2501  FORMAT!'  •,'*•»»»  MISSING  LANGUAGE  ASSIGNMENT  -  TERMINATING  A  SSE  MB 

r  l  v  | 


non 
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50  “FAril 5,51)  a 

51  rCRMAM  SI  .  1045  ,A1I 
«P I  IF  I ?,51l  4 

c 

C  0455  f.nMMFNT  CAROS  BFGINNING  «!  IH  •  AND  FLAG  OTHfo  NONRL  4NK  FIRST 

r  r.ni  umns  45  FP«n»5 


ono  non  onn 
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IF  TAU).FQ.H03} 
"  *111.  ' 


IF  ( 

LABEL  PROCESSING 


_ ,  .0  TO  SO 

NE .HOI  1  GO  TO  400 


100  IF  | A f 2f.EQ.HS9)  GO  TO  200 
IF  lAl2).E0.H)l)  GO  TC  900 
CALI  LA8L IN  IA|21,LC,tERRl! 

ir  iiE'’m.Eo.n  go  to  soo 

IF  ( IEARl.F0.2l  GO  TO  600 


IERRl.F0.2l 
OPCODE  PROCESSING 
200  IF  I  A  t  4 ) • EO  • H49 ) 


>  GO  TO  TOO 

S.AI4) ,PT ABLE, LI  NCR. ! ERR  21 
l  .OR.  1ERR2  .EO.  21  GO  TO  BOO 


CALL  PCOOE  (PASS 
IF  I1ERR2  .EO. 

IF  IIERR2.GE.JT  GO  TO  300 
LC*LCUINCR 
GT  TO  SO 

PSUEOO-OP  PROCESS ING 

300  CALL  PC  PS1  IB  IL INCR  »PASS» IERR? • A .LC  »  10UNMT*  C900T 
IF  (IEPR2  .NE<  01  lERCNf  »  1 FRCNT  ♦  1 
GO  TO  SO 

ERROP  MESSAGE  P0UTIN6S 

400  WRITE!  2,401  I 

401  FORMAN******  COLUMN  1  NOt  BLANK  OR  COMMENT  -  CARD  SKIPPED  *♦•♦•! 
IERCNT»1E»CNT*1 

r.n  to  so 

500  WRITE  12,501)  AI2T.AI3I  ... 

501  FORMAT!'*****  LABEL  ',A4t44,<  NOT  VALID  -  CARO  SKIPPED  **»•••) 
IERCNT  »  IFRCNT  ♦  l 

GO  '0  50 

600  WR I TF  <  2,401  I 

601  FORMAT!'*****  LABEL  TOO  LONG 
IERCNT  «  IERCNT  ♦  1 
GO  TO  200 

TOO  IF  I  M6T  .EO.  H491  GO  TO  SO 
WRITE  I  2 «  TO  1  I 

701  FORMAT ( * *****  OPERANDS  APPEAR  WITHOUT  AN  OPCODE 

f.  *  »  •  ) 

IERCNT  *  I  ERG  TN  ♦  1 
GO  TO  SO 

BOO  WR  I  TE  I  2,801)  A  (  4  I 
801  F'!P«AT  I  •  *****  OPGOOE 
C  «»*•*• ) 

I F  °CN  T  *  IERCNT  ♦  1 
GO  TO  SO 


TRUNCATED  TO  ST*  PLACES 


CARD  SKIPPED 


' , A4 , •  INVALID  OR  NOT  FOUND  -  CARO  TFRMINATEO 


900  PE  IIJPN 
EGO 

ccrccccccr.crrr.r.(.cccccrrccrf  rccccccrrcccccf  ccrcccccccrccccccccr.crcccccc 


or>r>  non  orto  non  non  n  on  ooi 
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CCCCCCCCCC  '■(JKIKAn  >UD«LU  I  inc  ,  I  1  ■  LC  = 

ccccccccrr.cr.cccccr.ccccccccccccccccccr.ccccccccccccccccccccccccccccccccc 


FORTRAN  SUBROUTINE,  TIUE  :  PASTWO  CCCCCCCCCCCCCCCC 


SUBROUTINE  PASTWO  ( LCOUNT , PTABLE , ST A8L E . IERCNT , L 1 S T 1 T 1 


INTEGER  HO 3 
DATA  H03/1HV 

INTEGER  PASS, At  21 J ,PT ABLE ( TOO) , STABLE  I  60) , CODE  I  16) .0PER1.0PER2 

INITIAL  I  2  A  T  f  ON 

PASS  =  2 
LC  =  LCOUNT 
00  10  I  -1,16 
CODE  I  I  1*0 
10  CONTINUE 

READ  CARO  IMAGE  FROM  DISK 

50  READ  <  2,5U  4 

51  FURNATtAl, 1944,431 
IF  t  At  II  .NE.  H01I  GO  TO  100 
NRYTES  =■  0 
GO  TO  700 

OPCODE  PROCESSING 

100  CALL  PCOOE  <P ASS , At 4) .PTABLE , l t NCR . I ERR2 .HOD.OPER 1 ,0PER2 .NUNCOOI 


100  CALL  PCOOE  <P ASS , At 4) .PTABLE , l t NCR . I ERR2 .HOD.OPER 1 ,0PER2 ,NU" 
IF  t  J  ERR  2  .EQ.  I  .OR.  IERRZ  .EO.  2)  GO  TO  106o 
IF  1 1 ERR2  .GE.  31  GO  TO  400 
NBTTES  =  L  I  NCR 

200  CODE! 11  «  NUNCOO 

IF  (OPFPI  .EO.  01  GO  TO  500 

OPERAND  PROCESSING 

300  CALL  OPEPAN  (MOD ,  A  ! «,  1  .CPER  l,  t  ERC00.0PER2  ,NVAL  l ,  NVAL  2,  NVAl  3 1 
IF  IIEWCOO  .EO.  11  GO  TO  2000 
IF  (IERCOD  .EO.  21  GO  TO  3000 
IF  ( MOO  .EO.  0|  GO  TO  350 
CODE! 11  *  CnnEt l I  ♦  NVALI 
IF  (MOO  ,NE»  5  GO  TO  325 
CODE! 1)  »  COOEt II  ♦  NVAL2 
on  TO  600 

325  CODE  1 2  )  =*  NVAL  ? 

IF  (0PER2  .NE.  5|  GO  TO  600 
COOEtTI  ■«  NV«L3 
GO  TO  600 

350  COnil 2)  =  MVAL 1 

IF  !0PE«1  .NE.  51  GO  TO  600 
CODE  I  3)  *  NVAL7 
GO  r0  400 

OSUEOr-I.’P  PR  Dr  E  5  5  I NG 

400  CALL  POPSlin  a  INCR.PASS,  IE»P7,  A.LC.CODE.  S  7000) 

IF  |  !£P»2  .FO.  1  I  GC  ID  4000 


UuU  Duo  U\J*S"  ODD  ODD  UUU 
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IF  (IFOR?  .EO. 
IF  ( I  ERR?  .EO. 
NRYfLS  =  LINCR 


7)  GO  TO  5000 
1)  GO  TO  6000 


WRITE  1C  ANO  C 006  INFOS  TO  TAPE  FOR  LOA0  TO  MEMORY 

600  IF  (MBYTES  .E0.  0)  GO  TO  700 
WRITfc  11,610)  MBYTES, IC.rOOE 
610  F0RMAT|22,76,16Z2) 

IF  LIST  IS  DESIRED,  PRINT  OUT  LC,  CODE.  AND  LINE 

TOO  IF  ILISTIT  .EQ.  0)  GO  TO  SO 
IF  (MBYTES  .NE.  0)  GO  TO  800 

PRINT  LINE  ONLY  FOR  COMMENTS  ANO  2ERO  LENGTH  PSUEDO-OPS 

705  WR  ITE  16,  7101  A 
710  FORMAT!*  •  ,  T  75 ,  Al  ,  1  a  A  A  ,  A  3 1 
GO  TO  50 
800  MBYTES  =  0 

IF  INBYTFS  .LE.  31  GO  TO  810 
MBYTES  -  MBYTES 
MBYTES  =  1 

PRINT  LINF  ANO  CODE  FOR  NORMAL  OP  COOES 

810  WRITE  16.8111  LC,<C00E(l) ,!*t. MBYTES) 

811  F0«MATI  *  *  .76,  31  ?X, 72  1  I 
WR  ITE  (6,9l2)  A 

812  FORMAT! '♦*, 725, Al. 19A6.A3I 

IF  (MBYTES  .EO.  01  GO  TO  R00 

PRINT  C.ONT  INUEO  LINES  FOR  BYTE  A,.D  WORD  INFORMATION 

WRITE  (6,8131  ICOOFItl, 

81 3  FORMA  Tl  '  •  ,  TR « 13(22,2X11 
900  LC  =  1C  *  l I NCR 

GO  TO  50 

ERROR  MESSAGES 

1000  WR  l  TE  I  6, 710)  A 
WR  ITE  (6,1001)  A  (  6  ) 

1001  FORMAT!*  ,,,**»»6  OPCODE 
C A  TEO  »**»»•) 

IF»CNT  =  IFOCNT  ♦  l 
LC  *  LC  »  LINCR 
GO  TO  50 

c 

2000  wp  !  TF  I  6,  T 1  0  I  A 
WRITE  16,2001) 

200 1  FORMAT ( •  « , • •••«• 

I 

(C»f.NT  *  IEPCNT  ♦ 

LC  -  1C  ♦  LI  NCR 

go  rn  so 


1=6, MBYTES) 


* , A6 , '  INVALID  CR  NCT  FOUND 


INVALID  OPERANO  ENCOUNTERED  -  CARD 


l 


C 

1000  WR  I  TF  I  6  ,  MO)  A 
WP  T  fR  (  6,  inoi  ) 


CARD  TERMIN 


TFRMINATED  * 


non  ooo  nc> 
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1001  FOP‘14  r  ( '  OVERLONG  OPERAND  ENCOIJN  TER  E  0  -  CAPO  TERMINATED 

r****«’ i 

I E °CN T  »  IEPCNT  ♦  l 
LC  *  LC  ♦  UNCP 
GO  TO  50 
C 

4000  WR  ITE  (6,7101  A 
WRITE  (6,4001) 

4001  FORMAT)*  *,*«***«  INVAL 10  OPERAND  -  NOT  PROCESSED  **»»**) 
iERCNT  =  IEPCNT  »  1 

LC  »  1C  ♦  UNCP 
GO  TO  50 
C 

5000  WR  ITE  I  6.710)  A 
WRITE  (  6,50011 

5001  FORMAT!*  *.**«*•*  OVERLONG  OPERAND  -  NOT  PROCESSED  ******) 

IERCNT  =  IERCNT  ♦  I 

LC  *  LC  ♦  l  I  NCR 
GO  TO  50 
C 

6000  WRITE  (&,  710)  A 
WRITE  i 6,60011 

6001  FORMAT!*  *.*»♦•*♦  LANGUAGE  OR  IERR?  ERROR  IN  POPSUB  *•*»*•) 

IERCNT  »  IERCNT  »  t 

LC  =  LC  ♦  LINCR 
GO  TO  50 
C 

£  routine  EXIT 

7000  IF  (LlSTIT  ,E0.  01  GO  TO  TOtO 
WRITE  (6.710)  A 
7010  PE  TURN 
cNU 

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC 
CCCCCCCCCC  FORTRAN  SUBROUTINE.  TITLE  »  POPSUB  CCCCCCCCCCCCCC 
^CCCCCCCrCCCCCCCCCCCCCCCCCCCCCCCCtCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC 

SUBROUTINE  POPSUB  I L I  NCR , PAS S » I FRR7 , A , LC .CODE , • I 


NOT  PROCESSED  **»»**) 


INTECFP  4(71), PASS, CODEl 161 

USE  UNCP  ir  (0CNT1FV  LANGUAGE 

l  IF  (LINCP.NE.il  GO  TO  1700 
IF  (PASS.r-0, 7)  GO  TO  ROO 

OB  PROCESSING 

100  IF  ( IFPD7.NE.31  GO  TO  700 
I  TYPE  *  1 

CALL  STRING  ( l  T YPE,  P A S S , 4 ( 6  I , NUMOPS . I E " COD  I 

IF  (IFPC.rin.EQ.il  GO  TO  1500 

IF  ( tfPCOn.E0.7l  GO  TO  1600 

( Ep R 7  -  O 

LC  =  I.C*  NUMOPS 

°r  tijpn 

ns  °ROCFSSfM G 


S5 


c 

c 

c 


c 

c 

c 


c 

c 

r 


c 

i 


c 

c 

c 


200  IF  I IFRR2.NE.4)  GO  TO  100 

te»cnr>  =  i 

Gill  VALUED  IM6)  .NUMVAL.ICRCOOI 
If  IlERCOO.EQ.il  6o  TO  1500 

IF  I ICOCUO.Ea.2 i  GO  TO  1600 

1  ERR 2  ’  0 
tc  =  tx  »  nunval 

RETURN 

OW  PROCESSING 

100  IF  (IERR2.NE.il  GO  TO  400 
1TYPF  =  2 

CALL  STRING  I! TYPE. PASS, 416), NUMOPS. !E«COOI 
IF  IfERCOD.EQ.l)  GO  TO  1500 

IF  IIERCOO.EQ.2I  GO  TO  1600 

(ERR?  =■  0 

1C  -  IX  ♦  INUMOPS  *  21 
RETURN 

END  PROCESSING,  ENDING  P4SS  ONE 

400  IF  IIERR2.NE.6)  GO  TO  500 
PE  TU»NI 

EQU  PROCESSING 

500  IF  (IERR2.NE.TI  GO  TO  600 
IERCOO  =  1 

till  VACREO  (AI6I .NUMVAt .tERCOOl 
IF  t IERCOO. EQ. It  GO  TO  1500 
IF  I  I ERCC0.EQ.2)  GO  TO  1600 
CATC  (.AflFIX  (AT  2)  .NUNVrtC  ,  tEXCOOl 
IF  IIERCOD.EQ.il  GO  TO  1500 
Ir  I IFPC0U.EQ.2I  GO  TC  1600 
I  ERR  2  -  0 
RETURN 

OPO  PR0CFSS1NG 

600  IE  IIERR2.NE.fl)  GO  10  700 
IfRCOO  -  V 

CAU  VALREO  (AI6 ) .NUNVAl , IERCOO) 

IF  I  IFPCrO.EQ.U  GO  TC  1500 
IF  I  ICR COn. EO. 2)  GO  TO  1600 
IEPR2  =  0 
IX  =  nunval 
R  E  TUPN 

R  ST  RRCr  E  S  S 1 NG 


TOO  IF  I  1 F° R 2  ,NE .  0)  GO  TO  1700 
lEPCTO  *  l 

CMC  V  AL  0  FO  I  A(  6)  .NUHVAL  ,  IERCOO) 
(F  (IFRroO.fQ.II  GO  TO  1500 
IF  I  IER'OO.EO.7)  GO  TO  1 600 
I F  RR  2  ^  0 
TC  *  I r  »  1 
RF  Tl|PN 


on  non  non  non  non  non  no  no  non 
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PASS  TWO  ROUTINES 


OB  PROCESSING 

800  IF  IIFRR2  .NE.  31  GO  TO  POO 
ITVPf  *  l 

CALL  STRING  UTVP£,PASS,A16»,NUN0PS,tERC00,C00E» 

1ER«2  =  IERC00 

IF  HERR?  .GT.  01  RETURN 

L  I  NCR  =  NUMOPS 

PETtlON 

DS  PROCESSING  ' 

POO  IF  IIERP2.NF.4I  GO  TO  1000 
IFRC00  =■  I 

CALI  VALRPO  ( A (6  ) » NUMVAL  , IERC00I 

IEPRZ  «  IERCC0 

IF  t IERR2  .GT.  01  RETURN 

l  I  NCR  -  NUMVAL 

RETURN 

0W  PROCESSING 

1000  IF  (IERR2.NE.5I  GO  TO  l 100 
I  TYPE  •  2 

CALI  STRING  I f T VPE, PASS  « A1 61 »NUH0P$ tlERCOO.CODEI 

IFRR2  *  IERCOO  4 

IF  | I FRR  2  .GT.  Ol  RETURN 

L I  NCR  -  NUHOPS  •  2 

RFTURN 

END  PROCESSING,  END  OF  PASS  TWO 

1100  IF  IIERR2.NE.6l  GO  TO  1-200 
IINCR  *  0 
RFTURN1 

EQU  P®CC E  S  S 1 NG 

1200  tF  UER»2.NE.T1  GO  TO  1300 
LI  NCR  =  0 
I  ERR  2  *  0 
.  RETURN 

ORG  PROCESSING 

1300  IF  11ERR2.NE.81  GO  TO  1400 
IlPCriO  =  1 

CALL  VAL»FD  1  A I  4  I , NUMVAL , IERCOO I 
IE°P2  ’  IERCOO 
IF  |  |  FRR  2  .GT.  01  RETURN 
L I NC°  -  0 
Lr  =  NUMVAL 
Turn 

RST  PPr<PC<!NC 


mm 
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c 

r 


c 

c 

c 


c 

$ 

c 

c 

c 

c 

c 

c 


c 

c 

c 


c 

c 

c 


READ  l  INS  OF  COOF 

10  BEAD  I  3,20,EF'n*600I  NBYTES.LC.CODF 
20  F0RMAT(Z2,Z4, 16221 
1*0 

IF  IK  .ro.  14)  NEWLIN  »  1 
IF  (NEWLIN  .EO.  0)  GO  TO  300 

WRITF  FINISHED  LINE  4N0  CREATE  NEW  LINE  HEIDI NG 

IDO  IF  IIFIRST  .CO.  11  GO  TO  150 
MAX  *  M  -  1 

WRITE  (7.1101  lALINEIIl,  1*1, MAXI 
1 10  FORMAT  1 4 1,44. 741 ,Z4  ,441 ,22,13(241  ,221 1 
150  IFIRST  *  0 

"■  (I  SPLIT  . FO.  II  LC  •  LC1 


TsF 


I  SPLIT 
LC  1  *  LC 
K  *  0 
N  *9 

200  4L  iNE  1 1 1 
4L INEI 21 
41 INEI 31 
4L  INE  14  I 
AL INE I  51 
4L INEI61 
ALINEITI 
41  INE  101 
ICUMMA  = 
NEWLIN  - 


HOI 

MEMORY 

HOD 

ICOLON 

LC1 

H12 

H10 

HU 


TEST  FOR  NflN-CONT I GUOUS  LC 
300  IF  ILC1  .NE.  LC I  GO  TO  10Q 
TEST  FOR  FIRST  NUMBER,  WHICH  NEEOS  NO  COHN* 

400  IF  (ICOMMA  .EO.  01  GO  TO  500 
400  COMMA  10  LINE 

ALINE(H)  =  HOB 

M  M  *  l 

ADD  ONE  BYTE  T1F  COOE 

500  ICCMMA  *  I 

ALINEIMJ  *  ICULON 
M  *  M  ♦  1 
L  *  l  »  I 

ALINEIMJ  -  COOEILl 
LC l  *  LC1  ♦  l 
K  *  K  *  1 
M  *  M  ♦  I 

TEST  FP°  END  rF  r.TOE  STP1NG  4N0  FTR  FILLED  LINE 


IF  (L  .CQ. 
IF  IK  .NF. 
(SPLIT  *  | 


‘I BY  TES  I  GD  Tn  10 
141  r,n  to  ado 


non 
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c.n  m  100 
600  MAX  -  M  -  1 

WRITE  17,110)  IALINEII),  I  -  1  .  MAX  ) 

RfcTUPN 

END 


cccccccr.cccccrccccccccccccccccccr.cccccccr.cccrccccecr.ccccccccrccccccccc 

CCCCC  FORTRAN  SUBROUTINE,  TITLE  !  LOOMEM  CCCCCC 

cccccccrcccrccccctcccccccccccccccccccccccccccccccccccccccccccccccccccc 

SUBROUTINE  LCONEM  IJN,jl,J2,*t 
DIMENSION  JNI9) 

OATA  ItOSfICOH  /  / 

COMMON  /TABLES/  SUT 7 , 1 5 ) , SI  I  3 , t 5 ) ,L 8  I  4 , 2 50 ) , C L ( 4 ) , 

*  NSU,N$L,NL8,NCL,NP,N$T,NSY,NPSAVE,MAXP,Pl 1) 

INTEGFP  SV,SU,SL,Cl,P,AI21l 

COMMON  /MORA/  S  V 1 5  000 1 ,  I  III  250  ) .  INB I  750 1  ,NS  V.  Nl  T  .  NT  R 

COMMON  /OAT  A/ I e, HOI ,H02,H03,H04,H05,H06,H07,H08 ,H09,HIO*H11 ,H12, 

1  H2 1 . H22 , H2  3 , H24, H3 1 ,H32*H41 #H42, M4  3  #  H44  *H  51 ,H52  * H53# 

2  H54.H55.H61 ,H62 ,H6 3 , H64 , H65 , H66 , H6 T , H68 , H69.HT0, H71 

5  « HT  2 


INTEGER  HOI ,H02.H03,H04,H05»H06,H07,H08,H09, H10.H11 .HI 2* 

*  H21 ,H22,H2 3 ,H24 , H3  1 , H 32 , H4 1 , H4 2 , H4 3 , H44 , H5 1 . H52 , 

*  H53,HS4.H55,H6I . H6 7 . H63 , H64 , H65 , M66, H6T , H6R.H69 , 

*  H70.H7t.H72 


10  READ  I 2,ll.ENO=6000l  A 
£l  FORMAT T  A  l . I9A4, A3| 

20  MR  I TE  16,711  A 
71  FORMA  T I '  •  ,A1,1SA4,A31 

IF  Mill  .NE.  H011  RETURN 
CALI  SFPUA(2l.lR.tB.INR,Nt 
1*  1 


40  IF 


I.GE.NI  GO  TO  10 
IBM)  .EO.  HOB  I  I  ’ 
(jNBljl.NE.il  GO  TO 


IF  1 
IF  I 
IF  I 
JN  ( 7 

MS-0 

CALL  FNAMEI JN,MS,t4100l 
IF  TjNIU.NE.il  GO  TO  50 
GO  TO  4000 


I  ♦ 

4000 


l 


memory 


50  IF  UNI  II  ,NE.  1  -OR,  IBU*t>  .NE. 
ir  \  1NB(  I  *2  I  .EQ . 7 1  GO  tU  80 
IF  jJl  .IT.  0)  GC  TO  4000 


60 

IF  1IBIIF7) 
J?*0 

.NE. 

HI  2 ) 

GO 

TO 

o 

o 

o 

*» 

IF  (  1  N8  I  1  *31 
J7-IBI ! *3) 

.NE. 

71  GO 

TO 

TO 

1-1*1 

TO 

IF  118(1*31 
1-1*3 

.NE. 

Hint 

GO 

TO 

4000 

GO  Tn  ”0 

80 

JI-IBII *7) 

I»  '  *1 

IF  1  1  B.I  1  *71 

•  NE  . 

HIOI 

GO 

TO 

60 

1-1*7 

00  !A4-|FQS 


H09)  GO  TO  4100 
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100  IF  (I I*2).GT.N1  GO  TO  10 

IF  IIHIIHI  .Nf.  1441  GO  TO  4000 
IF  I INP<i*2).NE.2l  GO  TO  110 
$VINSV*ll=-l01 
SV(NSV*2»=JNI  3) 

SVINSVO  *0 
SVINSV*4l*tM  1*21 
5VINSV*5I=JN(3) 

SV<NSV*6l*Jl*JNt  3  )  4  JN 1 4  I 
NS V=N  SV ♦ 6 
Jl=l*Jt 
1*1*2 
14  *  *  icon 

IF  (J2.F0.0I  GO  TO  100 
IF  IJI.1_6.J2>  GO  TO  100 
110  1*1*2 

GO  TO  40 

4000  f  411  ERROR  I  IE  .  1 .42 ,550001 
4100  C4LL  ERROR  (IE, 2, 42, 550 00) 

5000  RETURN  1 
4000  RE  I  UR  N 
10000  STOP 
FNO 


APPENDIX  D 


PREPROCESSOR  ASSEMBLY  LANGUAGE  ROUTINES 
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r 


9  i 


■K 

CL0'r.P( 

Z.oun' 

nc 

f • 2=4' 

uc 

CLP'CPr) 

3000' 

<JC 

F'22  8’ 

or 

clo'cz 

0000  * 

nr. 

F'204* 

(1C 

C  IS  >044 

100  O’ 

or 

F’M1 

nc 

CL8' OA0 

1320* 

or 

r  ">• 

or 

CC0'OB 

PI  ’ 

nc 

f  •  V 

oc 

CLB'Orp 

1210* 

nc 

F  1  8* 

oc 

CL8*ncx 

1320' 

nc 

f’ll' 

oc 

CL«'OI 

1000' 

oc 

F '  2  43 ' 

oc 

CLB'DS 

PI  * 

oc 

F  *4' 

nc 

CLB'nw 

PI  * 

nc 

F  '  5 ' 

oc 

CL8' El 

1000' 

uc 

F  '  2  0 1 ' 

nc 

c 1 8*  End 

PI  ’ 

nc 

F'fe’ 

nc 

CLB'EOU 

PI  • 

oc 

F»  7* 

nc 

CL3'HLT 

0 

0 

rj 

nc 

F*  UV 

oc 

C10'  IN 

2000’ 

nc 

'JC 

CL0' INR 

1210* 

oc 

F'  4’ 

oc 

CL0' I  NX 

1320* 

nc 

F  '  3' 

oc 

CIS* JC 

3000' 

or. 

F»210> 

nc 

C  L  8 ' JM 

30S0' 

oc 

F'?50' 

Of. 

CUT  JMP 

3000' 

nc 

f  •  ns1 

oc 

CL  8 '  JNC 

3000' 

or 

F'210* 

OC 

Cc  8'  JM l 

3000' 

OC 

F 1 104' 

oc 

CL0’  JP 

3000' 

oc 

F 1 242’ 

oc 

C18'  JPE 

3000' 

or. 

F  •  7  34 ’ 

oc 

CL  8'  JPO 

3000' 

oc 

t  '?24' 

or. 

cl  0*  jz 

3000' 

or 

F ’ 202' 

nc 

CL  3 '  L04 

3000' 

nr. 

F  '  F  0  * 

nc 

CL0'LOAX143O' 

nr 

F  •  10' 

nr 

C 1 0*  LHt n • 

or. 

r  •  4  / ' 

04 


IK 

CtS'LXI 

3  3?  S 

DC 

FT 

DC 

Clfl'xnv 

1811 

OC 

F  •  *4' 

DC 

Cl*'  *<V! 

22  1  A 

DC 

F  <6  • 

DC 

CIS'NUP 

1000 

DC 

F  •  0  1 

DC 

CIR'CIRA 

1110 

DC 

F'l  lb' 

DC 

CIR'CPr, 

PI 

DC 

F'R' 

DC 

C  L  *  '  G  R  I 

2040 

OC 

F ' 246' 

OC 

CLS'OUT 

20A0 

OC 

F  '  2  1 1 ' 

OC 

C  L  8 ' PC  HI  1 OOO 

OC 

P ' 231' 

OC 

CIS’ POP 

1320 

OC 

F'  101' 

OC 

Cl8'PUSHt320 

OC 

F' 107' 

DC 

CLS'RM 

1000 

OC 

F  1  2  3 ' 

OC 

CLS'RAR 

1000 

OC 

F'  31' 

DC 

Cl  8' PC 

1000 

OC 

F<  716' 

or 

CLR'RET 

1000 

OC 

F ' 20 1  ' 

OC 

CL8' RIM 

1000 

OC 

F  •  3  7  ' 

looo 

oc 

CIS'RIC 

DC 

F'  7' 

oc 

C18»R<4 

1000 

DC 

F  '  2  0  8  ' 

or 

C l 8 1 RNC 

loon 

DC 

F ' 208 1 

DC 

CL8' RN2 

1000 

OC 

F' 102* 

or 

Cl  8*  RP 

1000 

oc 

F  '240' 

DC 

CIB'RPF 

1000 

□C 

F '  2  32  ' 

oc 

CIR'OPO 

1000 

DC 

F  ■  224  • 

or. 

CIB'RRC 

1000 

oc 

F  *  l  5 ' 

oc 

CIS'RST 

PI 

oc 

F  •  0 ' 

nr 

Cl  8'  R 2 

1000 

oc 

F '200' 

oc 

CIS' SDR 

1110 

nr 

F •  152' 

DC 

CIR'SRI 

1040 

oc 

F  '  2  7  2  ' 

DC 

FAR'  SHLD3OS0 

or 

FMS* 

DC 

C  L  9  •  S  1  M 

1  mn 

•>r 

F  *  49* 

or  ci  «•  spuuoon* 

nr  r  •  -><,')  • 

OC  CIB’STA  10*50* 

nr  F  *  S  O' 

OC  CLR'STAXIATO* 

OC  F '  ?  • 

or  cl?*stc  iooo' 

oc  f  •  s  5 • 

OC  CLS’SUB  I  1 10* 

or  f*iv.' 

Of.  Cl  8*  Sin  70A O' 

OC  F*?IS* 

or  clb1  urnr. iooo1 

OC  F*238* 

or  CL8**PA  1110* 

OC  r*l68’ 

OC  C19*Y»I  ?040* 

OC  F*->18* 

OC  CIS’  tint  1000* 

OC  F*227* 

eno  rau  • 

F  NO  LOriASM 

/* 

/ / S  T  Ep  6  EXEC  A  jMFC  ,PA»H  =  *  NCOECK  ,Lr&0* 
//ASM. SCSI  !R  00  D$N=lE170.MACLItl,0JSP- 


in.  it  3i  in  uu  ujm-lElTO.MACLIBtOJSP-SHR 
//  00  ONN^SYSl  .MACUB,OISP  =  SHR 

//ASM. SY$PR (NT  00  dummy 

//AS**. SYSCO  00  OSN  =  U.ORJFr.T  ,0 l SP’ l MOO, P A S S I 
//ASM.SYSIN  00  • 

•»»•»*»♦♦*  ASSEMBLER  SUBROUTINE.  TITLE  :  LABLST  *»,»*.»*♦**» 

»t***t*»**t, •«»«**»***•»»**•***•»•»* 

LABI  NT  CSFCT 

ENTRY  I  A9ltN,PRlNST,LA8FU»tAB0UT 

*EQUR  EQUATE  REGISTERS 

USING  A.RIS  ESTABLISH  AOOR  ESS  ABILITY 

♦  ROUTINE  FOR  °L  ACl NG  LABELS  ANO  VALUES  INTO  SYMBOL  TABLE 

«  LABI  IN  (AI2I.IC,  I  ERR  I  » 

LABLIN  EQU  * 

STM  RU,RI?,:?|RlS|  SAVE  GENFRAL  REGISTERS 

LA  »l?,0  ZERO  ERROR  COOF 

L  R ? . 0 1 R l I  LOAD  AOOR  OF  LABEL 

MVC  SYMBINIfll .OIB?>  LOAO  IABEI  TO  SYMRIN 

* 

*  TEST  FTR  ALPHABETIC  FIRST  CHARACTER 


SAVE  GENFRAL  registers 

IFRO  ERROR  COOF 
LOAO  AOOR  OF  LABEL 
LOAO  IABEI  TO  SYMRIN 


CL  I  SYMBIN.C’A* 

PL  ERR INV 

CL  1  SYMBIN.C'I* 

BN  H  FULUR 

B  F  P  R INV 

LOOP  TO  1 0 AO  CHAPACTFRS  INTO  SYMBOL 


FIRST  CHARACTER  A? 

INVALID  IF  LOW 

FIRST  CHARACTER  l 1 

PROCEED  T C  FILLUP  IF  NC T  HIGH 

ELSE  CHAP  INVALID 


FILLUr 

MVC 

SYMBOt  U).  SYMflIN 

LOAO 

FIRST  CHAP  OF  $*M*UN 

Mvr 

SYMBOL  *11  /?  ,°l  ANAS 

FILL 

PfST  tfJTH  «IANKS 

l  a 

BA,  0 

Z  F  R  0 

pointer 

1  A 

BR,  1 

SFT 

1  NC^FMf NT 

F  ILCOP 


CUT 


l  A 

R9.S 

SET  LIMIT  INDEX 

L  A 

RS,  0 

ZERO  RS 

IF 

RS,  SYMBINHTR4) 

INSERT  CHAR  FROM  SYMBIN 

C 

R5.--F  '  l  22* 

CHARACTFR  :? 

BE 

nut 

END  OF  LABEL 

BXH 

R4  ,R  8  ,  EO  L  ONG 

IF  OVER  b  CHAR,  ERROR  LI 

STC 

0S,SYMBnL(R4) 

STORE  CHAR  IN  SYMBnL 

B 

F I  LOOP 

GET  NEXT  CHARACTER 

LA1FL 

4N0  VAl  UF  IN  STABLE 

EOU 

* 

L 

R6, POINTR 

LOAD  INOEX  TO  STABLE 

l  A 

R  7 , STABLE 

LOAD  AOOR  OF  STAPLE 

AR 

R  T ,  0  6 

FORM  TABLE  AOORESS 

mvc 

OIB.RT)  ,  SYM8CL 

MOVE  SYMBOL  TO  STABLE 

EA 

R7, 8(011 

INCREMENT  POSITION 

L 

0  1,  4(  R  1  1 

LOAD  AOOR  OF  LC 

MVC 

0(8,R7I,0(R31 

LOAD  LC  INTO  STABLE 

LA 

R6.12IR6I 

ADJUST  INDEX 

sr 

R6, POINTR 

STORE  POINTER 

B 

LEAVE 

LEAVE  ROUTINE 

routine  ro  seno  stable  to  main 


prinst 


MOV  I  Nr, 


USING 

EOU 

STM 

LA 

FOll 

L 

MV  C 

L 

l 

ST 

8 


♦,RIS 

014, R12,  12IR13) 

R  12,0 

R2,0(RU 

0(240.82/,  STABLE 

°2,4(ftll 

RJ. POINTS 

PT.0IR2I 

LEAVE 


STORAGE  FOR  PRINTING 

FS  T  A  BL  T  SH  AOOR E SS AB I L I T Y 


SAVE  GENERAL  REGISTERS 
ZERO  ERROR  CODE 


LOAD  ADOR  OF  STABLE  MAIN  PROG 

MOVE  ENTIRE  table 

LOAD  AOOR  OF  IPOlNT 

LOAD  POINTR 

PASS  POINTR  AS  TPOINT 


ROUTINE  TO  PROCESS  EQU  PSUEDO-UP 


LABFIX 


USING 

EOU 

STM 

LA 

LA 

L 

S 

AO 

L 

L 

l  A 
ST 
8 


*  .  R  l  S 

®l4,01?,t2(Rn» 

R  1  2 , 0 
R4,  STABLE 
04, POINTP 

H,=F'  12* 

H  4  ,  R6 
R2, 41 0  l  I 
R2, 0(021 
»4, 8IO4I 
02.0(04) 

L  f  AVE 


ESTABLISH  AODRESSABlL ITT 


SAVE  GENERAL  REGISTERS 
ZERO  ERROR  CPOE 
LOAD  AOOR  OF  STABLE 
LOAD  ROINTR  TO  R6 
OQINT  TO  LAST  TABLE  ENTRY 
FORM  ADOR  OF  FLEMENT 
LOAD  AOOR  VALUF 
LUAO  VALUE 

INCREMENT  POINTR  TO  LC  SPACE 
LOAD  REVISED  VALUE 
AND  LEAVE  ROUTINE 


ROUT  1 N F  TO  Eton  VALUE  EHCM  symbols  used 

P.PJS  ESTABLISH  aodo  essability 


us  INC, 

LAB0UT  FOU 
5TB 

T  1 
1 


014  ,0. 12,  1  2  TR  MI 
°  l  ?  .  0 
o>,0(0i | 


SAVE  GENERAL  REGISTERS 
ZERO  rnot)0  rnOE 
LOAD  AOOR  L4RVUM 


LA 

R4, STABLE 

L 

RB.OCINTP 

C 

BE 

0  5  ,  *F  '  0  * 

E-'ft  INV 

AR 

RS  ,R4 

SEEK 

EQU 

* 

CLC 

01  4  ,R  2  1  ,0I«4) 

BE 

FIND 

L  A 

»4, 12IR  41 

CP 

R4.RK 

BE 

ERR  INV 

B 

SEEK 

FIND 

FOU 

» 

l  A 

R4,  RT  R  4 

L 

04, 0IR4 

L 

P2.4IR1 

ST 

R4 , 01  R  2 

0 

B 

LEAVE 

* 

• 

HANDLING  ROUTINES 

ERR  1 NV 

EQU 

* 

L  A 

R 1 2 , 1 

B 

LFAVE 

ERLONG 

EQU 

* 

L  A 

R 1  2 , 2 

*  LOAD  FRROR  COOE  AND  l EAVE  ROUtINE 

* 


LQ  AO  AOOR  (IF  STAPLE 

LCAO  LIMIT  OF  STABLE  (NOE* 

RQINTR  =  0  ? 

tF  YES,  GO  TO  ERR INV 

SET  Lt«|T  ADDRESS 


COMPARE  TO  STABLE  ENTRY 
IF  EQUAL,  GO  TO  F [NO 
ELSE  INCREMENT  ADOR 


COMPARE  ADOR  TO  LIMIT 


IF  EQUAL,  GO  TO  INVALID 
ELSE  BRANCH  BACK 


INCREMENT  TO  LC  SPACE 
LOAD  LC 

LOAD  AODR  NUMVAL 
PASS  BACK  NUMVAL 
AND  LEAVE  ROUTINE 


SET  ERROR  CODE  ’  1 
LEAVE  ROUTINE 

SET  ERROR  COOE  *  2 


SYMBOL 
SYNB IN 
ODINTR 
Rl SNK  S 
STABLE 


EOU  ♦ 

L  R4.8 

ST  RlS, 

LM  R I  4 , 

HR  R 14 

OS  10 

OS  10 

nr.  f  « o ' 

DC  CL  B  * 

DC  240C1 

i.TORG 

END  LABI.ST 


RB.BIRI  J 
R12,0IR6l 
Rl4,Rl2,l2(Rlil 
R  14 
10 
10 
F'O' 

CL  B  ’  » 

240CL1'  • 


LOAD  AOOR  OF  ERROR  CODE 
PASS  BACK  ERROR  COOE 
RESTORE  GENERAL  REGISTERS 
RETURN 


SPACE  FOR  20  ENTIRES  IN  STABLE 


//STE °r  EXEC  AS'«FC,PAOM=«NODECK,L0AD* 

//ASM.SYSLIB  nn  0SN=IE170.MACL1R.DISP=SHR 
//  on  I)SN=SYS1  .MACL  IP  .01  SP*SHR 

//ASM. SYSPR INT  00  DUMMY 

//ASM.SYSGO  DO  DSN-.f.CnBJECT,DlSP-lMCO,PASS> 

//ASM. SY SIN  DO  ♦ 

«*****•*»«  ASSEMBLER  SUBROUTINE,  TITLE  :  PCCOE 

»»«**»***»*«»♦•**• t»***«5»i»i*ii»**»*»i**N»R {»**»♦*«« 


PCCOE 

begin 

CSETT 

$0  PEN 

F.  3  U 

* 

EQUATE  oFGISTfRS 

IBM  OPENING  CPNVFNTIONS 

L  i 

RIO.O 

ZERO  OFFSET 

La 

R  l  2 ,0 

ZERO  EBRCR  GCOE 

<;r 

0  l  7  ,L  EN 

ZERO  IINCR 

l 

”2,1(0  1) 

»Z  IS  PASS  ADOR 

'-*8 


L 

"2,0(021 

L 

R  3  ,  A 1  R  1  j 

L 

bn,  r\{p  1 1 

*  ERROR 

TFST 

AND  OFFSET  OF T E 

TEST  I 

ci.  r 

Olsjl.C'i* 

RNH 

TEST* 

FRROR 1 

LA 

R12.1 

B 

LEAVE 

TEST  l 

Cl  1 

0IR3I.C,0» 

BN  H 

TEST  3 

LA 

B 

RIO, 684 

SEARCH 

TFST3 

CL  I 

0 1 fl  3 1 iC'C* 

BNH 

1EST* 

LA 

RI  0,  360 

B 

SEARCH 

TEST4 

CL  I 

HI. 

01*31,0' 

ERROR! 

*  SEARCH  LOOP 

SEARCH 

LA 

pa,  30 

SLOOP 

L 

r. 

»5. SIR  1  1 
R6.0tR10.R5l 

BE 

FOUND 

HL 

NOTTNO 

LA 

RID. 12IR10I 

R  A , SLOOP 

HC  T 

NOTENO 

LA 

P12.2 

B 

LEAVE 

FOUND 

ft” 

• 

rs.rio 

CL  I 

RN6 

R5,4(R5I 

01  R  5) ,  C  'P  • 
ONEPAS 

L 

R12.MR51 

P5.1IPSI 

LA 

mvc 

1  EN»3(  l  I.OIRBI 

Nt 

LEN,3,X*0F' 

L 

R6.LEN 

L 

RA,  12(Pt» 

ST 

R6 , 01 RA I 

R 

leave 

PASS  ONE  PROCESSING 


R?  tS  PASS 

*3  IS  SEARCH  PCODE  ADDR 
R 6  IS  SEARCH  PCODE 


PCODE  GREATER  THAN  2? 

IE  NOT,  GO  TO  TEST? 

IF  YES,  ERROR  CODE  »  I 

LEAVE  ROUTINE 

PCODE  GREATER  THAN  0? 

IF  NOT,  GO  TO  TEST3 
IF  YES.SEARCH  BEGINS  AT  Q 
GO  TO  SEARCH 
PCODE  GREATER  THAN  G? 

IF  NOT,  GO  TO  TESTA 
IF  YES,  SEARCH  BEGINS  AT  G 
GO  TO  SEARCH 
PCODE  GREATER  THAN  A? 

IE  NOT,  ERROR  CODE  =1 


UNIT  OF  30  PROBES 
load  ADOR  of  PTABLE 
compare  ENTRY  TO  PC.Cjt-  TABLE 
IF  EQUAL  ,  GO  TO  FOUND 
IF  SMALLER,  BRANCH  OUT 
IF  NOT,  INCREMENT  POINTER 
B RANCH  ON  COUNT  TO  SLOOP 
IF  NOT  FOUNO,  SET  ERROR  CODE 
AND  LEAVE  ROUTINE 

SUM  BASE  AND  INDEX 

MOVE  TO  LENGTH  RYTE 

fEST  FOR  PSUEDO-OP 

IF  NOT  PSUEDO-OP »  GO  TO  ONEPAS 

SF.T  ERROR  CODE  FOR  PSUEDO-OP 

MOVE  TO  MOO  BYTE 

MOVE  LENGTH  TO  IEN 

CONVERT  TO  BINARY 

LOAD  LEN  TO  R6 

LCAO  ADDR  OF  L I NC R 

PASS  BACK  AS  LINCR 

AND  LEAVE  °OUT INF 


CNEPAS 

LOU 

* 

MVC 

1  EN  *3  I  l  ),OI»S» 

Mn VE  LENGTH  TO  LEN 

NI 

LEN,3,X'GF' 

CONVERT  TO  BINARY 

L 

RN.LEN 

LOAD  LEN  TO  R6 

L 

RA,  12  ( FI  I) 
R6,0(R*t 

LQAO  ADDR  OF  LINCR 

ST 

PASS  BACK  AS  LINCR 

C 

B  2  » =F  '  2  • 

IF  P A S  Ss  2 

"E 

TWO  PA  S 

GO  TO  OASS  TWO  HANDLING 

$ 

H 

l  FA  VE 

ELSE  LEAVE  ROUTINE 

•  PASS 

I  HO 

PROCESSING 

«  “ASS 

l.TK 

MOD,  nPER l ,  CPfp?, 

AND  NIJMCOD 

r. 


'»>) 


T  MOP  A  S 

EQU 

• 

MOO 

FQU 

• 

LA 

PS,  MRS) 

ADVANCE  POINTER  to  MOD 

MVC 

LENOl  1  i.oirsi 

MOVE  MOO  TO  LEN 

N I 

LENH,  K’Of' 

CONVER I  TO  BINARY 

1 

R6.LEN 

LOAO  MCO 

L 

R  ,  20  (  R  1 1 

LOAD  AOOR  OF  MOO 

ST 

RN  ,0(  R4  1 

PASS  RACK  MOO 

0PER1 

FQU 

* 

L  A 

PS, 1 (RSI 

ADVANCE  POINTER  TO  OPERt 

MVC 

LEN»3I 1 I.OIRSI 

LOAO  OPER  1  INTO  IFN 

N  I 

LEN*3,Y'0F • 

CONVERT  TO  BINARY 

l 

R6,  LEN 

LOAO  OPE R 1 

L 

R4 , 24  (  R  1 1. 

LOAO  AOOR  ()“ER  1 

ST 

R6.0IR4) 

PASS  BACK  OPER 1 

0PER2 

EQU 

* 

LA 

RS,  1 l»5 J 

ADVANCE  POINTER  TO  OPER? 

MVC 

LEN»3( 1  I.OIRSI 

MOVE  OPER 2  TO  LEN 

Nl 

L  EN  *3 , X  *0F  ' 

RS, LEN 

CONVERT  TO  BINARY 

L 

LOAO  OPER? 

L 

R4 , 28 1 R l ) 

LOAO  AOOR  OPER 2 

ST 

R6 , 0 1  R  4  ) 

PASS  BACK  OPER  2 

NIIMC  00 

EQU 

« 

LA 

R  5  ,  1 1 R  5 1 

ADVANCE  POINTER  TO  NltMCOO 

L 

R6 , 01  R  5  1 

LOAO  NUMCOO 

L 

R4. 32IR1I 

LOAD  AOOR  NUMCOO 

ST 

R6.0IR4) 

PASS  BACK  NUMCOO 

LEAVE 

L 

ST 

R6,  16IR1I 

R  1  2 ,0( B6J 

LOAO  RETURN  ADDR 

PASS  BACK  ERROR  COOE 

ENO 

EQU 

• 

SCLOSF 

IBM  CLOSING  CONVENTIONS 

LEN 

OS 

IF 

ENO 

pcooe 

/* 

//STEP8  exec  A$MFC  .PARM.'NQOECK.lQiO* 

//ASM.SYSlIB  00  'ISNMEITO.MAChS.OISP^SHR 
//  00  DSN=SYSl.MACLlB,Of  SP--SHR 

//asm.  syspp  in  r  on  tommy 

//ASM. SYSCO  00  OS  N^f.  /.OBJECT  , 0  I SP *  1  MOO  *  PAS  S I 
//ASM.SYSIN  00  • 

•••••••'••a*********************************************************** 

»*»**«•**•  ASSEMBLER  SUBROUTINE,  TITLE  :  STRING  ••**.*»««** 

••*»»*»«**  CALL  STRING! ITYPEjPASSjMGI jNUMCPS. I E» COD, CODE)  •»*•* 


STRING 


BEGIN 


CSECI 

TEJUR 

tOPFN 
TOU 
LA 
ST 


R  1  2 , 0 

R  I  2  >  ERCOOE 


SET  LIMIT  BY  TYPE 


EQUATE  REGISTERS 

IBM  OPENING  CONVENTIONS 

EERO  ERROR  COOE 

ZERO  ERROR  CODE  FOR  VAtREO 


l 

=  2 , ntR  1 1 

LOAD  l TYPE  AOOR 

l 

R  2 . 0  (  B  2  ) 

LOAO  I  TYPE 

1  Q 

“0.  R 2 

STORE  I  TYPE  IN  HP 

LA 

03,16 

LOAO  LIMIT  TO  R  3 

S  T 

R  3. LIMIT 

•  STO=E  LIMIT 

r. 

R?  ,  =f  •  1  ' 

ITYPE  =  I  7 

TFSUT 

IF  YES,  GO  TO  TESTIT 

ELSE  USE  l  IMIT  F'lR  WOOnS, 

l  A 

P  1  ,  B 

ST 

’  '  .1  IM|  1 

STORE  AS  | |M|T 

TYPE  2 


1(H) 


«  INIUAII2F  BY  PASS  CODE 
TEST|r  FQU  « 

i  R?,R|pn 

1  PJ.M»l  I 

L  RT.0I»31 

C  Rl.^F'l* 

BE  TST1NV 

l  R10,20(Rir 

LA  Rll.O 

ST  R2.A00R0P 

•  TEST  FIRST  CHARACTER  \ 

rsTiNv  eou  • 

Cl  I  OIR?) ,C4  ' 

BF  ERR  INV 

CLI  OIR2),C**** 

BE  OUOTES 

CLI  OIR2J.C*.* 

BE  ERR  INV 

LA  R'.,l 

•  MAIN  TEST  LOOP 

COMCNT  EOU  * 

CLI  OIR2I.C'  * 

HE  OU.NE 

CL!  OIR2l.C'.« 

BE  tJ°ONE 

B  INCR 

•  INCREMENT  ANO  LOAD  ON  PASS  2 


LQAO  AOOR  OF  POSITION 
LOAD  AOOR  PASS 
LOAD  PASS 
PASS  *  I  ? 

IF  SO,  GO  TO  VALIDITY  TEST 
ELSE  LOAD  AOOR  COOE 
ANO  LOAO  INDEX  TO  CUOE 
STORE  POSITION  IN  AODROP 


FIRST  CHAR  BLANK  ? 

if  res,  operand  invalid 
rt»sr  char  •  ? 

GO  TO  STRING  PROCESSING 
FIRST  CHAR  ,  ? 

IF  YES,  OPERAND  INVALID 
SET  COUNT  TO  I 


CHARACTER  BLANK  > 

IF  YES.  GO  TO  OONE 
CHARACTER  .  7 
IF  TES,  ADO  ONE  OPERAND 
COUNT  NEXT  OPERANO 


SU80l)t 


LA  PAtllRAl  INCREMENT  CP 

C  R4, LIMIT  LONGER  THAN 

BH  ERLUNG  IF  TES,  GO  T 

C  R  T, -F 1  I  '  PASS  *  I  7 

RE  INCR  IF  YES,  GO  T 

EOU  • 

I"  RT.Rl  ELSE  SAVE  R1 

TALI  V AIRE O.l ADOROP , NUMVAl , ERCODE  I ,  VL 
IR  °  1 , P  7  RESTORE  R1 


INCREMENT  OPERANDS 
LONGER  THAN  LIMIT 
IF  TES,  GO  TO  ERROR  LONG 
PASS  *  I  7 
IF  YES,  GO  TO  INCR 


L  ®6, ERCU0E 

C  R  f, ,  =F  *  0* 

8F  paSbak 

C  RA.^F'l' 

RE  ER°!NV 

8  FRLONG 

PASS  ONF  ANO  TNT  BYTE  VALUES  BACK 
1AK  FQU  • 

L  tb.numval 

C  R  9  ,  =F  1  2  1 

BE  TWORYT 

C  0S,-F'2SB' 

BH  t«RINV 

ST  RN.OIRH.RIOI 
LA  »t I ,4IR|I  I 

LA  P2, 1(021 

st  pp.Aonoop 

r. 

BE  MINE? 

b  rnurNT 

tyt  f  o  i  i  * 


LOAD  ERROR  CODE 
ERCOOE  =  0  7 
IF  YFS,  GO  TO  PASBAK 
ELSE  ERCCDE  *  1  7 
OPERANO  INVALID 
OPERAND  LONG 


I  T  Y  P  E  =  27 

GO  TQ  TWOBYT  LOADING 

VALUE  >  2SS 

IF  TPS,  OPERAND  INVALUO 
ELSE  PiSS  BACK  AS  COOE 

increment  inoex 

INCREMENT  POSITION 
STORE  POSITION  IN  AODROP 
LAST  OP  FLAG  -  t  7 
IF  YES,  GO  TO  DONE? 
CONTINUE 


G  RG,=F'  ISBSTN'  OVER  TWO  BYTES? 

PL  ,B|  IT  IF  LOW,  GO  TO  SPl  IT 


101 


LIMIT 

nnrjocp 

NUMVAL 

E»COOE 

SPACE 


FQU 

l 

sr 

«ci  osf 


B8,16(«ll 

IF 

IF 

IF 

IF 

IF 

STR  ING 


LOAO  AOOR  ERCOOE 
PASS  fl Af. K  ERROR  QCOE 
IBN  CLOSING  CONVENTIONS 


// S  T£P  9  EXEC  ASMFC ,P AR M= • NOQEC K .LOAD ' 
//ASM.SYSLtfl  00  OSN=  IE170.MACL I8,01SP*SHR 
//  00  OSN=SVSl.NACLlfl.OISP’SHR 

Z/ASM.GYSPR  INT  00  DUMMY 

//ASM.SYSGO  00  OSN=tCnflJECT,OtSP«lNnO,PASS» 
//ASN.SYSIN  00  ♦ 


EMBLER  SUBROUTINE.  TITLE  I  OPERAN  **»»**♦*•**• 

OPERAN  IN0D.AI6/I.0RER1,  I  ERCO 0,  CP ER  2  , NVAL  l  ,N  VAl  2 1  **• 

•»***»•*»*•********•••*•****••*•»*«»»••••*•••«»••••• 


••****»♦*«  ASSEMBLER  SUBROUTINE, 

,**»•****•  CALL  OPERAN  (NOD ,  A  1 6/1 1  ORE 

»**•*» ♦*»»«*♦♦***»*»«***•*»♦***»»**»** 

OPERAN  CSECT 
AEOUR 
in  pen 

* 

♦  RFGIN  PROCESSING  BASED  GN  VAtUE  Of 

* 

RFGIN  FOU  « 

LA  R12.0 

ST  R 1 2  . ER CODE 

L  R2,6lRlT 

l  R  2 , 01  R  2  I 

C  R 2 ,  -F  1 0  • 

BE  DATA 

LA  R  1 1  ,  1 

L  R3,AjRl» 


* 

*  RE 

» 

POFRFG 


READ  REGISTERS  AS  OPFRANOS 


RFGRFO 


FQU 

A 

M  VC 

REGIST! 4| .BLANKS 

L  A 

R  4 , 0 

1  A 

RS.O 

LA 

R",  1 

LA 

AQ,  5 

CL  1 

0 1  R  1 )  ,  C  '  ' 

BE 

ERR INV 

EQU 

* 

K 

RS.O(R4,R3l 

C 

RS, »f • IOT* 

BE 

FINISH 

C 

PS  ,  =F  *64' 

RE 

FINISH 

PXH 

R4 , R  R , ER  LONG 

s  r  c 

B 

R5,REGIST-!(R4J 
RE  OR  ED 

EQU 

♦ 

A  B 

R  3.R4 

1  A 

R  A  ,  1  1  0  A  1 

EQUATE  REGISTERS 

IBM  OPENING  CONVENTIONS 


EERO  ERROR  CODE 

ZERO  ERROR  CODE  FOR  VALREO 

LOAD  A DOR  OF  MOO 

LOAD  MOO 

MOO  •  0  ? 

IF  YES,  CC  TO  OATA 
SET  MODS  PASS  FLAG  -  I 
LOAD  A DDR  OPERANDS 


PLANS  OUT  REGIST  AREA 

ZERO  INDEX 

ZERO  RS 

SET  I NC  R  E  MFNT 

SE  T  LIMIT 

r  ibst  char  blank? 

IF  YES,  CHAP  INVALID 

INSERT  CHA»  INTO  RS 
CHAP  =  ,  ? 

IF  SO,  READ  IS  FINISHED 
CHAR  =  BLANK? 

if  yes,  dune 

OVER  3  CHAR  ,  rrc  LONG 
STORE  IN  REGIST 
GET  N  F  <  T  CHAR 

UPDATE  OPERAND  LOCATION 
MOVE  PAST  DFLIMITER 


!  i) 


•  Set  EC  T  OPERAND  I.IST  BY  *00  TYPE 

» 


c 

8H 

R  2,  SF  ’  2  • 

P«0C3 

BOO  «  2  7 

IF  NOT,  C,p  TO  PP0C3 

PROC  1  2 

FOU 

» 

L  A 

R5,l 1ST  t 

USF  listi  . 

B 

SEARCH 

DO  TO  SEARCH 

PROf.  3 

EOU 

• 

r. 

P2,-F*3* 

BOO  «  3  7 

PH 

PROF  4 

IF  NO.  00  TO  PRPC4 

USE  LIST2 

LA 

RS.Ll ST2 

8 

SEARCH 

00  TO  SEARCH 

PRDC  4 

EOU 

• 

C 

a  2 . *F  *  4* 

BOD  »  4  7 

BH 

LA 

PP0C5 

RS.LIST3 

IF  NO,  SO  TO  PROCS 

USE  1 1  ST  3 

PROCS 

EOU 

• 

USE  LISTI 

LA 

R5.I  t  ST  l 

♦  SEARCH  OPERAND  LIST  AND  MATCH 

*  F AILURE  TO  HATCH  INDICATES  AN 

fd  FINO  NUMBER  VALUE  OF  REGISTER. 
Invalid  register 

SF  ARCH 

EOU 

« 

COMPARE  REGIST  WITH  LIST 

IF  MATCH.  GO  TO  FOUNO 

LIST  ENTRY  »  7  7 

CL  C 

REGIST<4|,0IRS) 

BF 

FOUNO 

CL  1 

oi®si*c*l* 

BE 

ERR  1NV 

BATCH  NUT  FOUND 

LA 

8 

R5.BIR5I 

SEARCH 

increment  aodr 

FOUNO 

EOU 

• 

LA 

L 

C 

RS,4IR9I 

97.0IR5 J 

R2,=F<  Bl 

MOVE  TO  VALUE  WORD 

LOAD  VALUE 

BOD  •  5  7 

BF 

HODS 

IF  YES,  GO  TO  MODS 

*  SHIFT  NUMBER  THREE  PLACES  fOR 

BOO  2 

C 

OF 

R2.’F’2< 

SHIFT 

BOO  *27 

SHIFT  OPERAND  VALUE 

B 

PASSIT 

ELSE  PASS  AS  IS 

SHIFT 

EOU 

* 

2FR0  RA 

LA 

PA.  0 

N 

RA . -F ’ 8  * 

MULTIPLY  TO  GET  3  PLACE  SHIFT 

PASSI T 

EOU 

• 

l 

RS, 20IR  l) 

LOAD  ADDR  NVA|_  1 

ST 

°  T  .  0  1 R  5  I 

PASS  BACA  NVAL  1 

ST 

P  3  *  AODRL'P 

STORE  ADDROP 

C 

R  2  .  -  F  ’  S  • 

MOOS 

MOO  *  S  7 

(IF 

IF  YES.  SO  TO  BUDS 

n 

DATA2 

ISO  to  OAT  A2  FOR  NEXT  OPERANOS 

•  FOP 

0 

won  s, 

a  F  AO  NEXT  OPFRANO 

AS  REGISTER 

MPO*y 

FOU 

• 

'  a 

»» l ,1 IR  11) 

INCREMENT  BODS  PASS  FI  AG 

c 

SHIFT 

BODS  PASS  FLAG  =  2  7 

BF 

IF  YES,  GO  TO  SHIFT 

f 

«l 1  ,=F«  V 

BODS  PASS  FLAG  ■,  A  7 

'IF 

'RFPro 

IF  YFS,  GO  TO  PPFPFG 

( 

as.  IP  I  1 

FI.  SF  LOAD  ADDP  NVAl  2 

* 


sr 

8 


sr,n(»  si 

I  E  AVE 


PASS  9 AC K  NVAL  2 
AND  l EAVE  ROUT INE 


*  ROUTINE  to  READ  LABEL  ANO  NUME®  t  CAL  QATA 


eou 

L 

♦ 

RA.AIRtl 

LOAO  AOOR  OF  POSITION 

ST 

R4.A0DP0P 

STCRE  ADOPOP  FOR  CALL 

LA 

Rl.O 

FLAG  REGISTER  «  0 

LA 

86,20  , 

LOAO  NVAL  POINTER 

L 

R2.8IR1) 

LOAO  AOOR  OPERl 

L 

R2,  f)IR2) 

LOAO  OPERl 

C 

RR.'F’A* 

OPERl  *  A  ? 

86 

surcut 

IF  YES,  GO  TO  SlJROUT 
ELSE  SET  FLAG  REGISTER 

LA 

93.  1 

♦  USE  SURROUT IN£  VAIREO  10  RETRIEVE  NUMERICAL  VALUES 

SUBOUT  FQU  *  ‘ 

LR  ,  «9.Al  SAVE  *1  DURtNG  CALL 

CALL  VAl RED. ( AOOMOP,  NUMVAL,  ERCOOE) * VL  SUBR  FOR  NUMERICAL 
10  91,09  RESTORE  01 

L  8 1 1 , E 9 CCDE  LOAO  ERCOOE  . 

c  »ii,,fo*  ERCooe  *  g  ? 

«E  0°8  EO  IF  YES.  0,0  TO  OPREO 

C  <»  t  I  ,-F '  t  *  ERCOOE  •  l  ? 

RE  ERR  IN V  If  YES.  OPERAND  INVALID 

8  ERLONO  ELSE  QPFRANO  TOO  LONG 

OPREO  EOU  * 

C  R  3  «  =F '  1  *  OPERl  *  9  > 

8NE  NCR  TOP  IF  NOT.  00  TO  NEX  TOP 

* 

*  ROUTINE  10  SPLIT  LARGE  NUMBERS  INTO  TWO  BYTES.  LOW  OROER  FIRST 


VALCUT 

FOU 

• 

YALTST 

L 

R  5,  NUMVAL 

LOAD  NUMVAL 

EOU 

• 

C 

R'..=F’fc9S36» 

CUH/P 

NUMVAL  I1VE8  TWO  BYTEST 

Bl 

IF  LESS.  PRCCEED  WITH  SPl 

S 

H.  =6*68936’ 

ELSE  MAKE  MOO  65K 

8 

VAUST 

LOOP  RACK  ID  VAL  1ST 

CUTUP 

ECU 

* 

ST 

R9.NUMVAL 

STORE  NUMVAL 

Nt 

NUMVAL .2 , X 1 00 1 

2ER0  UPPER  BYTE 

L 

85,  NijMVAl 

LOAD  NUMVAL 

L 

Rll,0(R6,Rtl 

LOAO  PASS  BACK  AOOR 

ST 

RS.OIRUI 

PASS  BACK  NVAL  1 

L  A 

86, 4(961 

INCREMENT  R6 

1  A 

85,  0 

JERQ  R  9 

ST 

89 , NUMVAL 

2E»Q  NUMVAL 

ST 

85, SPACE 

LOAO  NUMBER  IN  SPACE 

MV  0 

NUMVAL*  T(  I  ) ,  SPACE*? 

LOAO  HIGH  byte  of  number 

L 

«S , NUMVAL 

LOAD  NUMVAL 

L 

HI  ,0IR6,o  I  ) 

B9,0|9ll) 

LOAO  PASS  BACK  AOOR 

ST 

PASS  SACK  NVAL? 

n 

L  p  A  VE 

ANO  LEAVE  ROUTINE 

♦ 


•  Loan  SIN'UF  ^yTF  OP^^ANO^ 
Nfxrop  rnu  * 


r. 

BNE 

RT.-F1 1* 

rrSroP 

L  A 

RE,  2  A 

8 

VAi  CUT 

EQU 

• 

t 

RA, NUMVAL 

C 

R  A  ,  =  T  '  Z  5  S  * 

BH 

ERL  ONC 

C 

R  3  ,  -  E  '  ?  * 

BE 

OPNUM2 

L 

ST 

Rii.zomt 
■A, 01*111 

TEST  DP 


♦ 

•  PROCESS  SECOND  DATA  OPERANO 

* 

DATA? 


* 

OPNUMZ 


EOU 

l 

l 

C 

be 

LA 

C 

BE 

LA 

B 


RZ,  16(  R  1 ) 
RZ, 0IR2I 
R  Z  •  -f  *  0 ' 
LEAVE 
R3,2 

P  2  •  =  F  •  A  1 
SUB  CUT 
R3,  3 
subout 


LOAD  SECONO  ONE  BTTE  OPERANO 


EOU 

L 

L 

ST 

B  ■ 


RA, NUMVAL 
RlI.ZAIRlI 
RA.OfRllI 
LEAVE 


ERROR  HANDLING  ROUTINES 


ERR  1 N V 

EOU 

« 

L* 

R  12. 1 

B 

LEAVE 

ERLONG 

EOU 

• 

LA 

R  JZ.Z 

LEAVE 

EOU 

* 

L 

#  1  1  . 1  Z  1  R  1  ) 

ST 

RIZ.OIR  111 

ACL  OSE 

AOOROP 

US 

IF 

NUMVAL 

OS 

IF 

ERCOOE 

OS 

IF 

SPACE 

OS 

IF 

RFGI ST 

OS 

IF 

BLANKS 

nc 

Cl  8 ' 

TEOIATER  OPTRANO  LISTS 


LI  ST  I 


EOU  » 

DC  CL  A' A 

oc  r • t  < 

nr.  c  l  >  •  b 

nc  E>o' 

nr  UA'r 


El  AG  REGISTER  •=  3  ? 

IF  NOT,  GO  TO  TESTOP 
IF  VES,  LCAO  NVAl  POINTEP 
ANO  GO  TO  VALCUT 

LOAD  NUMVAL 

numval  over  one  byte? 

ir  YES,  operand  is  too  long 

FLAG  REGISTER  =  27 

IE  YES.  GO  TO  OPNUMZ 

LOAO  AODR  NVAl  l 

PASS  RAG*  NVAL I 


LOAO  AODR  OPERZ 
LOAO  OPER2 
OPERZ  =  0  ? 

IF  YES,  LEAVE  RCUTINE 
SET  FLAG  REGISTER  TO  I 
OPER2  -  A  ? 

IF  EQUAL,  GO  TO  SUBOUT 
SET  FLAG  REGISTER  »  3 
GO  TO  SUBOUT 


LOAO  NUMVAL 
LOAO  AODR  NVAL  Z 
PASS  BACK  NVALZ 
ANO  LEAVE  ROUTINE 


SET  ERROR  CODE  -  1 
ANO  LEAVE  ROUTINE 

SET  ERROR  CODE  *  Z 

LOAD  JERCDD  RETURN  AOOR 

RETURN  TFRCOO 

BFTURN 


I  Oh 


NUNTST 

SETUP 

INOATA 

XPRES1 

XPRES2 

DONE 

VALFNO 

AOOEXP 

SIJREXP 


'MB?)  >  C  •  A  * 

ERR  INV 
01  R2  I iC'2 • 

NUM'ST 
R9,  6 
SF  TUP 
« 

0<R?) .C‘0* 

£BR INV 
0IR2I ,C*9» 

ERR  INV 
R9,9 
* 

LARNUNI9I, BLANKS 

«9.  I 

RS,0 

PA,0 

• 

RS.0IR2I 

R5,=B*64* 

OONE 

P5,*F*I07* 

OONE 

P  5 ,  =F • 78* 

XPP  ESI 
P  5 ,  =E ’ 96 ’ 

XPRES2 

PS ■ R8, ERLONG 
R5,LA'*NUH-n«41 

UblW2' 

hw 

RIO, 2 

* 

R9,=F'6' 

number 
R5,  Rl 

LAB OUT, (LABNUM, NUNvAL 
Rl,R5 
PI, EPCOOE 
R 1« *F  M  • 

EPft  INV 
• 

P2.  HR  Z 5 
R  7  ,  EXCOOE 
3  7  »  -T  '  0 * 

EXP  TST 
R  7 , «F •  l  • 

SUBFXP 

* 

rt.fxval 

R  7,  NUMVM 
0 7 . NUMVAL 
FxP  TST 

* 

“7.FXVAL 
P  7, NUNVAL 


FIRST  CHAR  -  k  7 
IF  LOW,  INVALID  OPERAND 
CHAR  =  7  7 

IF  HIGH,  TEST  FOR  NUMBER 
ELSE  LOAO  MAX  CHAR  »  6 
AND  RRANCH  TO  SETUP 

CHAR  *  0  x 

IF  LOW  INVALID  OPERAND 
CHAR  *97 

IF  HIGH,  INVAL 10  OPEPANO 
ELSE  LOAO  MAX  CHAR  >  9 

FILL  SPACE  WITH  BLANKS 
SET  INCREMENT  -  1 
ZERO  R  5 
ZERO  INDEX 

GET  CHARACTER 

CHAR  *  BLANK 

IF  YES*  OONE 

CHAR  =  ,  7 

IF  YES,  OONE 

CHAR  *  ♦  7 

IF  YES,  GO  TO  XPRES1 

CHAR  -  -  7 

IF  YES,  GO  TO  XPOES? 

IF  char  OVER  MAX,  GO  to  ERLONG 
STORE  CHAP  IN  CABNUM 
INCREMENT  POSITION 
GET  NEXT  CHAR 

SET  EXPRESSION  COOE  -  1 
GO  TO  DONE 

SET  EXPRESSION  COOE  -  2 

OATA  IS  LABEL  7 
IF  NO,  GO  TO  NUMBER 
SAVE  »1  DURING  CALI 
.ERCOOE) ,Vl 
RESTORE  R l 
LCAO  ERROR  COOE 
ERCOOE  =  1  7 

INVALID  OR  NOT  FOUND  VLAUE 

MOVE  POINTER  TO  NEXT  OPERAND 
LOAD  EXPRES  CODE 
COOE  3  0  7 

IF  YES,  GO  TO  FXPTST 
COOE  =>  l  7 

IF  NOT,  GO  TO  SUBTRACT 

LOAO  EXPRESSION  VALUE 
ADD  NIIMVAl 

STORF  RESULT  IN  NUMVAl 
GO  TO  EXPTST 

LOAO  EXVAl 
SUBTRACT  NUMVAl 


ms 


SI 

R  7  ,  NUMVAl. 

CXPTST 

EOU 

* 

C 

R10.=E*0* 

BE 

VALtUT 

L 

RT,  NUMVAL 

ST 

R  7, EXVAL 

R  10, EXCOOE 

LPL TST 

ST 

B 

VAlOUf 

FOU 

« 

l 

R6. NUMVAL 

l 

R/.AIR1) 

ST 

B 

P6.0IRZI 

LEAVE 

NUMBER 

EQU 

* 

S 

CLI 

R  ?  ,  =F  •  1 ' 

0  (  R  2 )  ,  C  *  H* 

BE 

HE  X  IN 

CL  l 

01R2) ,C'0« 

OE 

OC  T  IN 

CL  I 

0(R2),C,8* 

BE 

3  ININ 

DEC  IN 

FOU 

• 

LA 

S 

RT,  10 

CONVRT 

OCTIN 

EQU 

• 

LA 

RT,  8 

S 

R*,=r* !♦ 

B 

CONVRT 

BININ 

EQU 

* 

LA 

R  7 , 2 

S 

RA , =F  '  1  • 

CPNVRT 

EOU 

• 

LA 

R9  ,0 

LA 

PS,  0 

LA 

R8.0 

LA 

R6,  IS 

CTLOOP 

EOU 

• 

MR 

RB.R7 

IC 

RT.LABNUMIRS) 

NP 

RT.R6 

AR 

PR  ,H3 

LA 

PS,  I  (RSI 

BCT 

»<•  .CTLOOP 

:.i 

RT. NUMVAL 

1  A 

P  2  ,  1 1  R  2  1 

P 

VAL  END 

HEXIN 

nu 

• 

R7,  16 

s 

H,  =F'  1  • 

LA 

°s,o 

LA 

RB,  0 

L  A 

PT.n 

r»T 

RR.CHAR in 

uFXCVT 

• 

MO 

on,o  7 

1  A 

»  1, 0 

l  A 

“11,0 

l  A 

“5,16 

IC 

“  1  I  ,L  ABNIJMIRB  ) 

‘n  T 

°l  1  .CHAO  |  N 

STORE  result  IN  NUMVAL 

EXPRESSION  CODE  *  0  7 
IE  YES,  GO  TP  VAIOUT 
ELSEi  LOAD  NUMVAL 
STORE  IN  EXVAL 

store  express  cooe  in  excooe 

GO  TO  LBLTST 
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